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WHEN I WANT ADVICE ABOUT OBJECT-ORIENTED 
PROGRAMMING, I LL ASK AN EXPERT. 



SO, ASK US. 


You already know reusable class libraries promise a 
dramatic increase in productivity and efficiency for 
professional application developers. You also know class 
libraries created with one C++ compiler can't link with code 
created by another C++ compiler. And that libraries written 
in one language can't be used with client code written in 
another language. 

But here's something you might not know: Meta Ware and 
IBM are changing all that* 

Out With The Old. In With The New. The tight binary 
coupling that exists between object-oriented class libraries 
and client code means that changes to either—no matter 
how small—require a complete recompilation not only of 
the class itself, but of all the client modules 
as well* 

But with IBM’s System Object Model (SOM) 
and MetaWare's High C/C++ DirectToSOM 
compiler for OS/2, developers can break that 
tight binary coupling and extend the 
advantages of procedure libraries to 
object-oriented technology. 


Pretty amazing, right? And right now T you think this is where 
our pitch to set! you a compiler comes in. But you're wrong. 

information Only. And It’s Free. We know what you 
really want is information. That way you can make up your 
own mind about the benefits of SOM and the DirectToSOM 
High C/C++ compiler for OS/2, We ve prepared a white 
paper that will help. It's called Truly Reusable Objects 
Directly From C++: How to Create and Distribute Them. It's 
yours just for the asking. 

To receive your free Information, call, fax, or e-mail 
MetaWare at the numbers shown below. Once you review 
the facts for yourself, you’ll understand why MetaWare and 
IBM mean "objects made easy/ 



CALL 40& 429 6382 
FAX 408 429 9273 
OR 

E-MAIL TECHSALE5@METAWARE.COM 
FOR YOUR FREE COPY. 

TODAY. 


MetaWare 

OBJECTS MADE EASY 
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The Suite Way to Build 
Portable Applications 




I s building applications 
your job? Then life just 
got easier thanks to the 
zApp' Developer’s Suite 
for Windows. The zApp 
Developer’s Suite is a set of 
highly integrated C++ devel¬ 
opment tools designed to help 
you transform the blueprints 
in your mind into commercial 
quality applications—quickly 
and easily. And best of all, 
applications built using the zApp 
Developers Suite are portable to fourteen 
different platforms! 

The zApp Developer’s Suite consists 
of zApp, the award-winning portable C++ 
application framework; zApp Factory™, a 
fully visual application designer and code 
generator; and the zApp Interface Pack, a 
collection of high-level visual objects for 
the zApp environment. All of these tools 
are highly integrated to provide maximum 
ease of use and flexibility. 


complexity; all in one powerful but easy 
to use environment. With the click of a 
button, you can engage a powerful test 
mode which lets you interact with your 
application, seeing it exactly like your 
end user will see it: letting you fill in 
dialogs, pull down menus, etc. When you 
are pleased with the look and feel of your 
application, fully commented C++ source 
code is only a mouse click away, thanks 
to the zApp Developer’s Suite’s code gen¬ 
eration capabilities. 


work, and the zApp Interface 
Pack, so you have all of their power 
at your disposal — toolbars, table 
objects, advanced graphics — in 
all, over 300 object classes of power 
just waiting to be tomorrow’s best¬ 
selling application. 

Portability and More. 

When you're done building your 
application, then you can decide 
what platforms you want to support! 
Applications built using the zApp 
Developer's Suite are single-source portable 
to fourteen different platforms. By simply 
recompiling, your application will run 
natively on Windows, Win32 (Windows 
NT, Windows 95, and NT on the DEC 
Alpha), OS/2’. DOS Text, DOS Graphics 
and seven X/Motif platforms: IBM 
RS/6000 AIX, HP HPUX 9.x, SGI IRIX 
5.2, SCO UNIX, Sun Solaris 2.x, Sun 
SunOS 4.1 .x. Sun Solaris x86. 

Free Demo. 


Rapid Application Development. 

Introducing an exciting new visual tech¬ 
nology that lets you drag and drop a wide 
assortment of objects like toolbars, 
tables, and 3D dialogs; define their char¬ 
acteristics; and build interfaces of any 


Object-oriented Power. 

The best news is that this development 
environment sits on top of zApp, the 
industry leading C++ application frame¬ 


Sound impossible? Well, if seeing is 
believing for you, call 1-800-346-6275, ask 
for our free demo disk, and get a glimpse 
of what the future has to offer. 



zApp and Inmark are registered trademarks of Inmark 
Development Corporation. /App Factory is a trademark of 
Inmark Development Corporation. OS 2 is a registered trade¬ 
mark of IBM. All other trademarks arc the property of their 
respective owners. 
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INMARK 


2065 Landings Drive, Mountain View, CA 94043 
T: 800-346-6275 or 415-691-9000 F: 415-691-9099 

In the U.K. and Scandinavia, call PTS/Software Plus 
at +44 (0) 928 579900 

In France, call PTS/Software Plus at (05) 908194 
In Germany, call F.SM Software at 07022-9256-0 
In Italy, call Silicon Valley On-Line at (049) 654221 
In Australia, call Micro Way at (03) 580-1333 
BBS: 415-691-9990 • Internet: info<tfinmark.com 
CompuServe: GO INMARK 
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• The Bestselling I 
OS/2® Books 
Now Have One Thing 
|_in Common.. J 

V 

They*re 

Wiley 
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Books. 



PrOgf aTTtnlin ^Ver>io’‘ ) 


:»» Develop'^ 

W. 22 SS 2 S 


Featuring the most complete 
list ol OS/2® books for 
programmers, developers 
and end-users... 

Now including all titles 
from the VNR OS/2® Library. 


PROGRAMMING 
THE OS/2® WARP GPI 
Stephen A. Knight 
& Jeffrey M. Ryan 


OBJECTS 

or OS/2 


Danfort / 


OS/2 War, 
Workplace 
Shell API 

Mindy Pojjacfc 

Edited by Marc St^L 
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Available now at bookstores 
everywhere and from IBM Pub Order. 
To order direct, call Wiley Computer 
8ooks at t-800-225-5945. 


For more information, 
e-mail compbks@jwiley.com 



0-471 -10718-2 
(SR2B5601) $39.95 

CLIENT/SERVER 
SURVIVAL GUIDE 
WITH OS/2® 

Robert Orfalr 
& Dan Haritey 
0-471 -13118-0 
(SR2854940Q) $39.95 

OBJECTS FDR OS/2® 
Scott H. Danforth, 
Paul Koeneo 
& Bruce Tate 
0-471 -13126-1 
(SR28556800) $44.95 


DEVELOPING 
HIGH-POWERED 
OS/2® WARP 
APPLICATIONS 
David Reich 
0-471-115S6-X $34.95 

OBJECT-ORIENTED 
PROGRAMMING 
USING SUM 
AND DS0M 
Christina Lau 
0-471*13123*7 
(SR28557000) $39.95 


OS/2® WARP CONTROL 
PROGRAM API 
Marc A. Stock 

0-471*03887*3 $29.95 

OS/2® WARP 
WORKPLACE SHELL API 
Mindy Pollack 
& Marc A. Stock 
0-471-03872-5 $29.95 

OS/2® WARP 
PRESENTATION 
MANAGER API 
Marc A. Stock 
& Joel Barnum 
0-471-03873-3 $29.95 
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Gammatech REXX 
SuperSet/2 

by Softouch Systems 

The SuperSel /2 gives REXX the power of C by 
providing Interfaces to LAN Server. NetBIOS. 
TCP/IP and Communications Manager/2, and by 
providing access to low level system facilities, 
including processes, threads, semaphores, 
names, pipes, and VIO commands. The 
SuperSet/2 complements visual REXX program¬ 
ming packages. The ©00+ page manual fully documents over 300 
functions in 7 DLLs ready to supercharge your REXX! 


Programmer's Editor 

by RimStar 
Technology, Inc, 

Features: 32-bit GUI, Syntax 
Coloring. ANSI “C" macro language. 
“C* Source Browser, unlimited 
redo/undo, no limits on number of files, windows, or line length. 
Emulates BRIEF plus many other editors. Compile/jump to error, hex 
editing, smart indenting, bookmarks, completely configurable key¬ 
board mappings. WF/2 enabled and much more. Windows & NT 
versions available. 


Ours: $69 


FAXmera#: 3621-0002 


Ours: $259 


FA Kmera #: 1013-0901 


Farad™#. GTGR 3310 G 


kayOlMJVS 
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Prominare Designer 

by Prominare 

A PM programmer’s tool for the 
creation of fully featured GUI’s for 
OS/2, Acting as an extended 
resource editor, Prominare sup¬ 
ports all OS/2 controls for all 
versions of OS/2 including Warp. 

Its inherent flexibility enables the power of C to be fully exploited, 
with the added benefits of intelligent code generation. 

Ours: $495 FXXceter* #: 1017-8601 



Relish 

by Sundial Systems 

Calendar, to do's t and phone book are 
fully Integrated for total reliability, 
yet also independent for maximum 
flexibility. Schedule realistically for any 
time and duration, double-hooking as 
necessary; categorize commitments: 
repeat events: print schedules: run 
programs: dial calls: prioritize to do's. 

Drag-drop, desktop objects ("Buns"), keyword searching, expert 
system for times/dates. Easy, convenient, CUA compliant, 
OS/2 Certified. 

Ours: $S9 FAKceum #: 1015 9901 



Fan**™#: FRDGO3100 
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Watcom VX*Rexx 
Client/Server 2.1 

by Watcom 

A visual development environment for OS/2, 
Powerful connection, query and chart objects 
allow you to access several databases, manip¬ 
ulate data and chart the results quickly and 
easily. Features Include drag-and-drop 
programming: bound controls: professional 
multi-threaded, multi-windowed and drag- 
and-drop enabled application development. 


Ours: $275 


FAXrrfrm#: 1683-0022 


B DOS * WINDOWS ■ NT * UNIX * OS/2 • SUN 
As fiW * RSeOOO • HP900G • MAC: * QNX * BANYAN 

* SCO. This well known, highly portable 
data management package has become 
established as the tool of choice for commer¬ 
cial development. Offering unprecedented 
data control, choose from direct low level 
access, ISAM level, or SQL access with the 
FairCom Server. Single User, MulU User, or optional Client/Server. 
ANSI Standard, Full Source. No Royalties. 


c-tree Plus® 

by FairCom 


FAIRCOM* 

since 1979 


Ours: $495 


FAXcetem #: 1381-0004 
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The Object Factory—IDL 

by Synaptec, Inc. 

IDL development environment lor OS/2 
SOM. Includes multiple inheritance, 
framework fillers. Drag-drop backup 
and restore, a SOM class browser, on-line 
help and much more. Use class development 
notebooks to create new classes just by 
dropping them on the class browser. Eliminate the complexities of 
SOM programming. Framework filters focus development providing 
quicker access to the hundreds of SOM classes. View every inherited 
method from every parent in one list box. Manage class development 
with great ease and liUle effort. 

Ours: $229 FAXcetou #: 1012 5402 



Farad™#: 5NOFO3T00 


To order call: 800-445-7899 

Corporate Developer Division: 800 441-1511 
FAX: 908 389-9227 
International: 908 389-9228 
Customer Service: 908 389-9229 
Programmer's, Paradise Deutschland: 
TeL; 08121/79073 - FAX: 08121/76566 
Programmer's Paradise Italia: 
Tel.: 39-2-967-00409 * FAX: 39-2-967-02S5S 
Programmer's Paradise UK: 
Tel.; 0161 7284177 • FAX: 0161 7284017 
For more in formation on the 
products featured on these pages call 
FAX atini'i {908) 389-8173 
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: n Editor s 
Comments 


Dragging and Dropping 


O S/2's Graphical User Interface support is the 
best in the business. The Common User Access 
mouse and keyboard standards and the ever- 
evolving Workplace Shell give the user a logical, help¬ 
ful, and friendly way to move around and get things 
done. The rest is up to the applications. 

Fortunately, the OS/2 GUI development platform 
is equally rich. Whether you write native Presentation 
Manager applications or use one of the excellent visual 
tool products, some great OS/2 applications are possi¬ 
ble. In this issue of OS/2 Developer, we offer some sug¬ 
gestions. Our authors share their tips and techniques on 
some basics of GUI: prototyping a new application, 
writing to the API, and, most important, designing an 
interface that is right for the intended audience. While 
few of us have had to develop an online reservation sys¬ 
tem, it is a great case study for the GUI programmer 
(see Mark Gayler's article). 

See you at the IBM Technical Interchange in New 
Orleans. Laissez les bon temps roulet! 



Following is a letter to Lou Miranda regarding his article in 
our March/April 1995 issue: 

Dear Mr. Miranda, 

In the closing comments of your article "OS/2 Pro¬ 
gramming for the Windows Guru'' {OS/2 Developer VoL 
7 No. 2), you state, "Don't be tempted to use OS/2's 
memory allocation features,.and suggest the use of 


malLocO from the standard C library. 

While, admittedly, this does provide bet¬ 
ter portability, it eliminates consideration 
of a very powerful OS/2 (and Unix) con¬ 
cept: Shared Memory* (I have been told 
Windows provides shared memory as 
well, but I don't do Window's!) 

Thanks for an entertaining article. 

Except for this one minor statement, I 
found it quite interesting, 

Jonathan McCirr 
Chief System Architect 
Sterling Software, Banking System Division 
}onathnn_McGirr®bsdst erling.com 

Dear Mr. McGirr, 

Thanks for your recent letter and kind words regard¬ 
ing my OS/2 Developer article. 

You are absolutely correct that you must use OS/2's na¬ 
tive memory API functions (such as Dos Oloc Sh a redHem ()) 
if you wish to use shared memory. As my article stated, 
there are exceptional cases where it makes sense to use 
OS/2 API functions instead of the standard C/C++ nal- 
loc() and nev(), and this certainly is one. However, due 
to a lack of space, I gave only one example (allocated 
but uncommitted memory) and couldn't list all of them, 
such as your example. 

Thanks again for your comments. 

Low Miranda 

73567A71@compuserve.com 



Dick Conklin 
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OS/2 Toolbox 


This issue, our OS/2 Toolbox column reviews a GUI design tool from Prominare Inc. By GUY SCHARF 


Prominare Designer 
Release 4 



Gw/ Sdmrf 


P rominare Designer Release 4 is a 
GUI design tool for designing the 
windows, dialogs, menus, and other 
resources of an application. It generates the 
resource script and skeleton code for an ap¬ 
plication. Running on OS/2, Prominare 
Designer will generate code and scripts for 
any version of OS/2, Windows 3.1, and 
Windows NT. You can select C or C++ and 
can use the CommonView, IBM ICLUI, 
Borland OWL, or ObjectPM class libraries. 
For OS/2, you can design an application as a 
Presentation Manager or Workplace Shell 
application. 

You can import existing OS/2 or 
Windows resource files. A Presentation 
Manager Control Extension (PMCX) feature 
allows you to use Prominare Designer to de¬ 
sign applications using your own controls. 

An extensive set of rules controls source 
code generation. You can modify the rules to 
tailor the standard module and function 
headers, select which Presentation Manager 
messages are processed, and define the pro¬ 
cessing code for each message. You can set 
the default prefixes for generated symbols to 
match your naming conventions. 

The manual states that 8 MB of memory 
is required and 16 MB is recommended. The 
product requires 10 MB of disk space with 
source code examples or 8 MB without the 
examples. 

I tested C language generation for OS/2 
and briefly examined ICLUI code, 1 did not 
explore other platforms or class libraries. 


USING PROMINARE DESIGNER 

When you first start Prominare Designer, it 
asks whether you want to start a new design 


or work on an existing design. A design con¬ 
sists of one or more windows and dialogs, 
which are reflected in a resource script. 
Figure 1 shows the dialog presented for a 
new design. Typical of Prominare Designer 
screens, this form includes many buttons 
and boxes, only a few of which need to be 
set. For a new design, the one required field 
is the "Basename" entry field. Here you 
enter the name of your project. This name 
will also be used as the filename stem for the 
include file and for the source file that will 
contain the mai.nO program. You can ask for 
the resource script to be generated as an .RC 
file for use with the OS/2 toolkit or Borland 
resource compilers, or as a binary .RES file. 
Other radio buttons allow you to specify the 
language, target environment, and other 
controls. The notebook allows you to specify 
the directory in which source files for differ¬ 
ent platforms are to be placed. 

To create a new dialog or window, click 
on the New Window button on the toolbar 
or select New... from the Edit menu. 
Prominare Designer presents you with a se¬ 
lection of common window configurations: a 
plain dialog window; a dialog window with 
OK, Cancel, and Help buttons arranged 
along the bottom or right side; a secondary 
window; a pop-up menu; a notebook page; a 
settings notebook; or a set of common di¬ 
alogs such as a Product Information or a File 
Open dialog. Select the type of window de¬ 
sired, and it is created, along with any push 
button controls. 

Figure 2 shows the Window Styles dia¬ 
log presented for each new window. Using 
this dialog and its subsidiary dialogs, you set 
window styles, set presentation parameters, 
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Migrate your code to 32-bit OS/2 NOW! 



Delivers 



SMART’ 

Source Migration Analysis Reporting Toolset 


SMART Tool Helps 
Migrate Your Code 

Get a jump on 
your competition 
...Get SMART/ 

Get One Up Corporation’s 
SMART Toolset through 
The Developer Connection 

for OS/2 


Now you can get SMART through The 
Developer Connection for OS/2. 

SMART analyzes YOUR Windows’" code 
(16-bit or 32-bit), and OS/2®code (16-bit), 
sizes the conversion effort, and automatically 
converts the MAJORITY of YOUR code to 
32-bit OS/2. 

When you have completed your migration, 
you'll have a state-of-the-art application that 
exploits all the advantages of 32-bit OS/2, the 
leading-edge PC operating system available 
TODAY! 

The Developer Connection for OS/2 is a 
CD-ROM containing lots of great tools for 
your OS/2 programming. It is updated 
quarterly, and comes with a newsletter. 

How do I get SMART? 

To get the complete SMART Toolset, as well 
as future versions of the tool, simply join The 
Developer Connection for OS/2. For more 
information or to subscribe to The Developer 
Connection, call 1-800-633-8266 (in Canada 



1-800-561-5293). 


®IBM and OS/2 are registered trademarks of 
International Business Machines Corporation. 

™The Developer Connection for OS/2 logo is a trademark 
of International Business Machines Corporation. 
TW SMART-Source Migration Analysis Reporting Toolset 
is a trademark of One Up Corporation. 

™Window$ is a trademark of Microsoft Corporation. 
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and define any other characteristic of a 
window that a resource script can 
specify- Default values for other fields, 
such as the dialog procedure name, are 
generated from the window title* If you 
are generating source code, you need to 
specify the filename for the source code. 
Use the Messages*.* button to say which 
Presentation Manager messages should 
be processed in the window procedure* 
If you need to handle WM_CH AR or UH_MOUSE- 
HOVE, just click on those entries in the 
message listbox and the case statement 
for those messages will be placed in the 
source code along with skeleton code to 
handle those messages. 


Once you have selected the type 
of window desired, you place controls 
on the window in the same way as 
with OS/2's dialog editor: click on the 
tool palette or select a control from the 
Control menu, then click with the 
mouse to place the control in the win¬ 
dow* A dialog for setting the control 
styles is displayed. The same dialog al¬ 
lows you to select which VM.CONTROL no¬ 
tification messages are to be processed. 
Figure 3 shows the styles dialog for the 
listbox control. 

To resize controls, drag their cor¬ 
ners or edges with the mouse. A con¬ 
trol alignment button on the toolbar 



Figure 1 , Creating a new design. 



Figure Z Window styles for anew dialog. 


displays a dialog to align, size, or 
space controls* To rearrange push but¬ 
tons from OS/2's along-the-bottom 
style to Windows' on-the-right-side, 
select that push button alignment 
style. To change a control type, such as 
from an entry field to a spin button, 
just press the Change Control Types 
button on the toolbar and pick the new 
control type. 

When your design is done, save 
it, or press the Generate Code button 
on the toolbar, and the resource script 
and application code are written for 
you* Use your compiler's IDE to gen¬ 
erate a makefile and compile the code. 
To add application logic, edit the gen¬ 
erated source code with your favorite 
editor. You can make further design 
changes using Prominare Designer; 
generate the source code again, and 
your changes to the source code will 
be preserved* 

A common problem for Pre¬ 
sentation Manager programmers is 
that a dialog designed on a high-reso- 
lution screen may not fit on a VGA 
screen or text may be seriously 
clipped, Prominare Designer provides 
two aids for these problems* The VGA 
Screen Template button draws a box 
showing the VGA 640x480 screen size. 
The Show Control Limits toolbar but¬ 
ton draws a box around all text, show¬ 
ing approximately how the text will be 
displayed on VGA. As a visual aid, the 
box is green if the text fits in the con¬ 
trol without dipping and red if clip¬ 
ping will occur. Figure 3 shows these 
marker boxes. The calculation is only 
approximate, so you must still check 
operation on VGA before shipping the 
product. However, the calculation is 
an enormous benefit during the design 
process, as it allows you to anticipate 
and design for other screen resolu¬ 
tions. A Dialog Font Metrics utility 
will capture font and scaling informa¬ 
tion for new display types* 

Prominare Designer has dialogs 
for creating and maintaining menus, 
accelerators, string tables, help tables 
and subtables, and all other resource 
script components* It has menu selec¬ 
tions to generate help tables and sub¬ 
tables, and it will create a skeleton IPF 
file from these tables. If will even gen¬ 
erate an accelerator table for you from 
your menu definition—provided you 
spell the accelerators exactly right in 
the menu text* According to the ven¬ 
dor, Prominare Designer supports 
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every resource type except RCDATA, RCIN- 
CLUDE, FK ALONG, and FKASHQRT. 

Promioare Cosigner is very fiexi- 
ble in importing dialog definitions 
from RC, RES, DLL, and EXE files and 
symbols from header files. With the 
lean application code generated, I have 
found this tool helpful in altering ex¬ 
isting applications—something I 
would not attempt with other source 
code generators. 

CUSTOMIZING PROMINARE DESIGNER 

One of the greatest strengths of 
Prominare Designer is the flexibility it 
offers the programmer for customizing 
its operation. When you select 
Con figure/Creation options..., you are 
presented with a 21-page notebook 
that allows you to define the default 
styles, size, and presentation parame¬ 
ters for each type of control. If it can be 
specified in the resource script, the de¬ 
fault values for controls of that type 
can be set here. When you later place 
controls of this type in a dialog, you 
can modify the styles of that instance 
of the control as desired. 

As an aid in developing or porting 
multiplatform applications, Prominare 
Designer presents a superset of all pos¬ 
sible styles. Styles unique to OS/2 Lx, 
OS/2 2.x, and Windows have distinc¬ 
tive colors. This color coding makes it 
easy to remain aware of any platform 
constraints of the styles. 

Source code generation is gov¬ 
erned by a set of rules. These rules de¬ 
fine every aspect of the source code: 
contents of the main() program, win¬ 
dow and dialog module headers, win¬ 
dow and dialog procedure outlines, 
which messages should be included by 
default, and what code should be in¬ 
cluded for each message type. Figure 4 
shows the rule (skeleton code) for a 
ENABLE message. Buttons on this dia¬ 
log bring up editing windows for edit¬ 
ing the comments immediately follow r - 
ing the case MN_ENABLE : statement and 
for editing the program logic up to the 
break statement. You can modify the 
processing logic for any Presentation 
Manager message. 

Prominare Designer supports both 
a master set and an application set of 
rules. When you create a design, you 
choose to use either the master set or 
the application set. If you choose ap¬ 
plication rules, the master rules are 
copied to the application. Any future 
changes you make to the rules affect 


only the application copy. This ap¬ 
proach allows you to have a standard 
set of rules for your organization while 
allowing the rules to be tailored to a 
specific application when required. 

Prominare Designer imposes some 
constraints on the overall program 
structure. Every procedure consists of a 
switch statement with case statements 
for each message and a break at the end 
of the code for the message. The gener¬ 
ator does not support constructs such 
as placing all WM_CGHMAND processing in a 
separate function, but rather it supports 
only the typical structure with all case 
statements in the window procedure. 
Since you can change the rules for pro¬ 
cessing each message, you could make 
calls to common message processing 
functions if desired. 

CUA compliance is checked each 
time you change a window or control. 
Thirteen different CUA issues can be 
checked; each issue can be selected or 
deselected in the CUA compliance dia¬ 
log. CUA checking is too thorough at 
times: the design tool checks the con¬ 
tents of static text controls, which CUA 
does not require. 

PRESENTA TION MANAGER 
CONTROL EXTENSIONS 

Many developers create controls for 
use in their applications. The PMCX 
feature allows you to incorporate those 
controls into the Prominare Designer 


design environment. These new con¬ 
trols and their styles are then fully 
supported in the resource script. 
Unfortunately, messages and notifica¬ 
tion codes for PMCX controls are not 
supported for source code specifica¬ 
tion and generation. 

Implementing a PMCX control re¬ 
quires placing the control in a DLL 
and adding three DLL entry points 
(Ux% Register, XjuxQuery, and AmStyles) 
that tell the designer how the control 
works and what its styles are. A fairly 
complex data structure is passed be¬ 
tween the designer and the control to 
communicate all of the options. Once 
this interface is included, a custom 
control can be used just like any of 
OS/2's controls. To add a color wheel 
to a dialog, just select the custom con¬ 
trol tool, pick the color wheel control 
from the list, and place it on the dialog 
like any other control, 

Prominare Designer includes 17 
PMCX controls, all with full source 
code. These range in complexity from 
three-dimensional line and text fields 
to date and time fields, a color wheel, 
and a notebook with pages. While 
some of these controls may be directly 
usable, their only documentation is in 
the source code for the controls, 

DOCUMENTATION 

Prominare Designer includes a 340- 
page manual. About half of the man- 



figure 3 . Listbox control styles. Red and green boxes on the dialog predict VGA text dipping . 
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ual is a reference manual, arranged in 
order of the menu items. A short tutor- 



eluded. A separate chapter describes 
the Presentation Manager Control 
Extensions. Appendixes include a de¬ 
scription of CUA compliance checking 
and comparison of OS/2 and Win¬ 
dows controls. Indexing is poor, mak¬ 
ing it difficult to find some informa¬ 
tion in the manual. Learning how to 
generate help tables and IPF files was a 
matter of experimentation, as the doc¬ 
umentation focused on what you 
could do, not what you should do. 

The tutorial and PMCX sections of 
the manual are available online as INF 
files. Online help is provided. Un¬ 
fortunately, the panel displayed in re¬ 
sponse to the help button or key is 
often not helpful. For example, asking 
for help on the Window Styles dialog 
results in a help pane! saying this is 
the Windows Styles dialog, without 
any discussion of the fields in the dia¬ 
log. An exploration of the help panels 
reveals that there are more appropriate 
help panels, complete with hyperlinks 
to more detailed information. It may 
be that the help button is displaying 
help for the menu item instead of for 
the dialog; if so, that should be fixed. 
However, since the better panels are 
not now displayed when needed and 
the help contents panel is not orga¬ 
nized, finding information in the on¬ 
line help is difficult. 

WARTS AND BLEMISHES 

I found Prominare Designer to be stable 
in my testing. I had one problem with 
an incorrect resource script generated 


with OS/2 Warp selected as the target 
platform. The vendor quickly provided 
me with a fix. I also encountered a prob¬ 
lem caused by missing data when con¬ 
verting from C to C++ ICLU1. The ven¬ 
dor identified the problem and called 
me with a solution within a few hours. 

Poor online documentation and 
manual indexing make learning the 
product much more difficult. There are 
nooks and crannies of the product that 
I have not figured out yet. 

The dialogs are crowded, with 
every possible setting usually pre¬ 
sented on one dialog. Entry fields and 
listboxes for symbolic names are often 
too short for long names. Some list- 
boxes lack horizontal scroll bars, mak¬ 
ing it impossible to see the full text of a 
listbox item. If you have changed your 
default system font to something 
smaller than the standard lO.System 
Proportional, the dialogs dip text mer¬ 
cilessly. I had to reset my system font 
back to 05/2's default setting to read 
Prominare Designer's dialogs. 

The functions you need while de¬ 
signing a window are available either 
on a convenient two-row toolbar or on 
the menu. Many of the toolbar options 
are not available from the menu, so 
you will need to use both the menu 
and the toolbar. 1 was disappointed by 
the lack of context menus (right mouse 
button pop-up menus) in the window 
design environment. You must move 
to the toolbar or select a menu item for 
functions that might be reached more 
easily from a context menu. 

Defining a menu is less than ideal, 
as you have to add items to a list 
rather than manipulating a visible 



Figure 4 . Rule (skeleton code) for W-ENABLE message, 


menu structure. As usual for 
Prominare Designer, though, you can 
set any possible style for a menu item. 

LIMITS OF APPLICABILITY 

The greatest strength of Prominare 
Designer is the total control over the 
resource file and extensive control over 
generated source code offered the de¬ 
veloper. This product could be useful 
to developers working in C or C++ 
who want to design in a graphical en¬ 
vironment, exploit resource scripts, 
and generate tailored skeleton code for 
the application. 

You can customize the skeleton 
code greatly, resulting in code tailored 
to your organization's or personal re¬ 
quirements and style. However, you 
can not write your application logic in 
Prominare Designer. Instead, you must 
use an editor to add application logic 
to the generated code. If you later 
change the design or need to have code 
generated for additional messages, 
Prominare Designer will regenerate the 
source code and try to retain your 
changes. In my testing, this worked for 
changes in the window procedures. 
Changes in the main program and 
other places were not always retained. 
In all fairness, the manual does state 
that certain areas should not be 
changed, as they are critical markers 
used in the code generation process. 
Rather than using special marker lines 
or comments, Prominare Designer uses 
the skeleton code in the rules to deter¬ 
mine how the source files have been 
modified. If you delete code from the 
rules and regenerate the source, the 
code previously generated may be re¬ 
tained in the source modules. 

Prominare Designer is not a rapid 
application development or visual pro¬ 
gramming tool. It lacks high-level con¬ 
structs such as a table display or SQL 
query tool. Prominare Designer does 
support all OS/2 control styles that 
can be specified in a resource script. 
Additional features that must be im¬ 
plemented by messages are mostly not 
supported. Thus, you can define note¬ 
books and notebook pages, but you 
can not put pages in the notebook be¬ 
cause that requires procedural code. 
Similarly, you can define a container 
control, but making it show a details 
or other view requires writing applica¬ 
tion code. 

You can add custom controls so 
the design environment incorporates 
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your custom design elements. You can 
create objects that have your own func¬ 
tionality or that work around some 
product limitations. For example, one 
of the PMCX controls provided with 
the product is a notebook control that 
includes the pages in the notebook. 

Prominare Designer will generate 
code for different target platforms 
(OS/2, Workplace OS, Windows), for 
different versions on each platform 
(OS/2 1.x, 2.x, Warp; Windows 3.1, 
NT), and for different compilers or 
class libraries at the click of a button. 
This flexibility may be useful for gener¬ 
ating a skeleton application for a differ¬ 
ent platform or for converting an appli¬ 
cation from C to a C++ class library. 

TECHNICAL SUPPORT 

Technical support is available by fax, 
electronic mail, or in the OS/2 Vendor 
Forum (OS2AVEN) on CompuServe. 
OS2AVFN is a recent addition to the 
company's support offerings, and ac¬ 
tivity has not built up there yet. My 
questions submitted via fax or e-mail 
were answered promptly and com¬ 
pletely, often within hours. 

Most unusual is that Prominare 
Designer contains built-in support for 
documenting and reporting problems 
and making suggestions. Pull-down 
menu items take you to notebooks for 
writing suggestions or documenting 
problems. After you fill in the pages of 
the notebook, you can print the form 
to any printer, save it as an e-mail file, 
or copy it to the clipboard for pasting 
into another document or program. 
With a fax printer, you can print to the 
fax printer and have the report faxed 
directly. There is one minor glitch in 
faxing directly: the fax number is not 
shown on the dialog, so you have to 
print the document to see the fax num¬ 
ber or look it up in the manual. The 
vendor has told me that the fax num¬ 
ber will be included in the dialog in a 
future revision so that this process will 
be even easier. 

All suggestions and reports are re¬ 
tained in a database. You can retrieve 
previously submitted reports to review 


or send them again. The program re¬ 
members information such as your 
name and system configuration, so fill¬ 
ing out reports is easier after the first 
one. Including the support mechanism 
within the product indicates to me a 
vendor commitment to service and 
support that I find refreshing. 

SUMMARY 

Prominare Designer gives you com¬ 
plete control over the resource script 
and allows you to tailor skeleton code 
to exactly match your needs. The abil¬ 
ity to import resources from other plat¬ 
forms and to save resources and create 
source code for different targets may 
help in porting applications. While 
documentation problems make learn¬ 
ing the product more difficult, similar¬ 
ities to OS/2's dialog editor make 
basic layout and design familiar. Lack 
of higher-level constructs and support 
for application code make this a low- 
level tool for the Presentation Manager 
application developer rather than a 
high-level rapid application develop¬ 
ment or visual programming tool. 

Guy Sofiarf is president of Software Architects 
Inc, a software development firm specializing 
in developing OS/2 Presentation Manager 
applications for vendors and business. He can 
be reached via CompuServe at 76702,557 or at 
Software Architects Inc2163 Jardin Drive, 
Mountain View, CA. 
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GUI Comer 


Continuing the printing theme from last issue, the weighty topic of fonts is tackled. 

BY MARK BENGE and MATT SMITH 


Fonts 101 



Matt Smith 


r ype (n) a piece of esp. metal having 
on its upper surface a character in 
relief which when inked and 
brought under pressure against paper leaves 
an impression of the character. 

Font (n) a complete set of types of a particu¬ 
lar size and face. 

(Taken from the New Lexicon Webster's 
Dictionary of the English Language ) 

The process of setting type remained 
unchanged from the time of Johannes 
Gutenberg until the late nineteenth century. 
During that period, type was hand set, 
meaning each letter composing a word was 
selected and grouped with other letters 
placed within a composing stick. As groups 
of sentences were formed, they were placed 
in a galley. These galleys would form the 
paragraphs on the printed page. 

This hand setting method was partially 
replaced by two methods in the late nine¬ 
teenth century. The first method. Monotype, 
was based on a machine that could cast the 
type as individual characters. The second 
method. Linotype, cast the type as a com¬ 
plete line. These were then placed in galleys 
that formed the final page. 

Unlike hand-set type. Monotype and 
Linotype were not reused. Hand-set type 
was based on the reuse of performed type 
that would be sorted and stored as individ¬ 
ual characters. Monotype and Linotype w T ere 
based on melting down the lead (later a zinc 
alloy) type for reuse. 

This machine casting of type was done 
by a typesetter sitting at a type of keyboard 


that was much like a typewriter (if you 
have ever seen a Linotype machine, the key¬ 
board layout is not at all similar to a qwerty 
keyboard). The typesetter would press each 
key corresponding to the letter needed, the 
machine would select the mold from its ma¬ 
trix of characters, and the characters would 
fall into position within a setting bed. Once 
the line of characters was complete, the 
molten lead or zinc alloy would be injected 
into the setting holder and the line of type 
formed. 

Once the metal had cooled sufficiently, 
the line of type would be removed from the 
setting bed and placed with other lines of set 
type. The molds that formed the line of type 
would then be placed within the sorting 
mechanism of the typesetting machine to be 
sorted back into the letter matrix. 

It wasn't until the 1960s that typesetting 
changed. Until this time, type had always 
been metal based. During the middle of the 
decade, a new form emerged: phototypeset¬ 
ting. This involved the use of a photo¬ 
graphic projection of the type from a film 
negative onto light-sensitive film or paper. 
The characters were set at a keyboard in a 
similar fashion to a Linotype machine 
except that the keyboard resembled the 
qwerty layout. 

The next major leap forward, with 
which we are all quite familiar, was digital 
composition. This arrived in force in the late 
1980s with the wide acceptance of PostScript. 
Here, the font is described in a mixture of 
raster and vector (mathematical) forms. The 
final font is then created usually through the 
use of a laser projected either on a photo¬ 
sensitive drum or directly onto film. 
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WHAT'S THIS GOT TO DO WITH US? 

As you can see, major advances in the 
setting of type were few and far be¬ 
tween until the 1960s. Since then, 
many changes have taken place. Over 
the last few years, within our personal 
realm of the computer desktop, we 
have seen the attached printer go 
from daisy wheel, to high-end dot 
matrix, to 300-dpi laser printers, to 
1,200-dpi and color laser printers. 
Correspondingly, we have seen our 
selection of fonts go from one or two 
to literally hundreds. 

While the technology of using 
fonts has changed radically, much of 
the terminology and the concept of 
how type looks on the printed page 
has not. What is different is the ease 
with which it gets there. Okay, that's a 
loaded statement. The ease depends on 
your point of view. If you are the user, 
yeah, easy is the operative word. If 
you are the programmer, well... 

We have to concern ourselves 
with the relationship of type to our 
programming so we can better under¬ 
stand how our fonts (basically the 
fonts that come with our operating 
systems and printers) relate to the rest 
of the world. Figure 1 shows the basic 
terminology used within the printing 
industry. It also shows the correspond¬ 
ing fields within a font metrics struc¬ 
ture that is used within OS/2 to actu¬ 
ally describe the fonts. 

Yeah, so what? By looking at some 
of these arcane items, you can better 
understand how closely (or distantly) 
the architects of OS/2 followed the tra¬ 
ditional use of fonts. 

FONT MAGIC 

So what are the areas with which we 
want to concern ourselves? The two 
most obvious are the font size and face 
name. These are two of the items that 


will bond your application with the 
user. Most users understand in general 
terms these two items. To be able to 
use them in your apps, you need to 
understand a bit more. 

Many of us first muttered unprint¬ 
able things regarding the baseline and 
its location. Why is it where it is and 
not at the bottom of the character? 
Why didn't those weenies providing 
the font metrics support stick it in the 
right place? 

Well, they did. The baseline is part 
of the traditional font description. What 
the designers of the font support within 
Presentation Manager have done is pro¬ 
vide compatibility not for programmers 
but for the printing industry. 

You can see they have carried the 
terminology across as much as possi¬ 
ble. The only differences are how the 
point sizes are described and the Em 
square definition. Generally, we refer 
to the height of a font in points. For ex¬ 
ample, this font you are reading is 9- 
point Pa latino, 

In the field sNominalPointSize in the 
FONTHETfilCS structure, the point size is 
not the actual point size but the size 
one magnitude higher. Why? Since a 
font can be defined as being 8.5 points, 
for example, a problem describing the 
font arises. So as not to introduce real 
numbers within the font metrics, it 
was decided to define the font size as 
an integer value. If you want to deter¬ 
mine the true size of the font within 
the sNominalPointSize, simply divide it 
by 10. 

As for the Em square, traditionally 
it has been known as the Em quad, 
which was the point size as a square. 
In OS/2 Presentation Manager, the Em 
square is defined through two fields of 
the font metrics in world coordinates 
instead of the point size. These two 
fields are lEmHeight and lMnc. 


In conjunction with the point size, 
you need to understand two fields of 
the font metrics structure that ulti¬ 
mately determine how you interact 
and select fonts from the system. These 
are sKDeviceRes and sYOeviceRes. These 
two fields do not relate directly to the 
traditional font descriptions; they are 
really provided as a means of allowing 
you to select the appropriate font defi¬ 
nition for the device you are targeting. 

These fields will contain either the 
device resolution (Table 1) or 1000, The 
device resolutions have been defined 
for CGA, EGA, VGA, and XGA, When 
a scalable font is being defined, the res¬ 
olution is 1000. This value along with 
other information (FH_DEFN_0UTLINE flag 
within the fsDefn field of the font met¬ 
rics) allows you to determine which 
fonts are device-specific or more global 
in nature. 

SO HOW DO f PICK A FONT? 

Generally, you can use the same 
methodology to select the fonts for a 
hard copy output device as you would 
with the display. Some of the tech¬ 
niques for manipulating and scaling 
the fonts are the same. The real differ¬ 
ence is through a selection mechanism, 
namely, the Ufatch field of the font met¬ 
rics structure. 

Each font has a unique identifier 
associated with it, the lflatch number. 
You can refer to this number when se¬ 
lecting a font. But what does this num¬ 
ber really mean? Essentially, it is an ID 
value for the font, nothing more and 
nothing less. And, to make things just 
a bit more difficult, the number is the 
same during the life of the session that 
is running, but there is no guarantee it 
will be the same from computer to 
computer. Therefore, you can not re¬ 
ally use this as a sneaky way of refer¬ 
ring to fonts. 
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Figure 1. Printing industry and Presentation Manager terminology. 
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Where this value is useful is in 
providing you with a shorthand nota¬ 
tion to a font you want to use. You can 
easily inform the system that you want 
a particular font by using the IHatch, 
This in effect guarantees that when 
you find a font you need, such as 
Helvetica 8 point, you can get it when 
you use its corresponding IHatch value. 

Now comes the tricky and not 
very well documented part about the 
IHatch, Most of us understand that 
printers are provided with built-in 
fonts. Since these fonts are designed 
for the machine, they are generally bet¬ 
ter in resolution than a font that is 
downloaded to the printer. So how do 
you ensure you have selected the 
printer font and not a system font? By 
checking that the value of the IHatch is 
negative. Negative? Why negative? 

The negative IHatch is used by the 
operating system to indicate that the 
font select selected is specific to the de¬ 
vice. This helps to ensure that this font 
is not selected for a display when a 
printer device context has been used in 
picking the fonts. 

INTO THE HERE AND NOW 

With this basic understanding of the 
font, along with the magic areas within 
the font metrics structure, we can 
begin to apply this knowledge to how 
we use fonts within our applications 
and how we actually begin to use 
them on the printed page. Remember 
that fonts have been designed for use 
on the printed page and not so much 
for the computer screen. 

For selecting the proper fonts for 
the display, we first need to get the 
screen device context using GpKJuery- 
Oevice. Then, using this value, we use 
the OevQueryCaps to determine the dis¬ 
play resolution so we can match the 
sKDeviceRes and sYDeviceftes values of the 
font metrics. 

Using a presentation space for ei¬ 
ther the window where we want to use 
the font or the desktop, we request the 
public fonts. After getting them, we 
move through the array of font metric 
structures looking for the font face 
name, szFacenane, and the font size, 
sNofninalPointsize. We do this in con¬ 
junction with checking to see if the 
sKOeviceRes/sYOeviceftes matches the cur¬ 
rent display device resolution. If we 
have a match on all accounts, we grab 
the IHatch and use it to select the font. 
This number is used with the FATTRS 


structure along with the face name to 
get the proper font for the window. 

If we can not find the font as a de¬ 
vice (bitmap or raster) font, we can re¬ 
scan the font metrics array looking for 
a font that matches the face name and 
is scalable. Again, we use the IHatch to 
select the font, but this time, we have 
to do a bit more work to get the font to 
the appropriate point size. The reason 


is that the font is defined within the 
system as a set of mathematical 
splines, whereas the device (bitmap or 
raster) font is defined in the proper 
size as a bitmap image. 

We first call GpiSetCharHode to set 
the character mode to CH_HQ0E3, which 
allows scaling of the font. After we 
have calculated the corresponding 
height of the font in device coordi- 
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Display type 

sXDeviceRes 

sYOeviceRes 

CGA 

96 

48 

EGA 

96 

72 

VGA 

96 

96 

800x600 

96 

96 

1024x768 

120 

120 

1280x1024 

120 

120 


Table 1. Device resolutions. 


nates, we scale the font using the 
GpiSetCharBox call. 

For the printer, the methodology 
is very similar, as we mentioned be¬ 
fore. The only difference is that you 
will have to create the printer device 
context first (perhaps by using the rou¬ 
tines from our previous column) and 
then use the same techniques we de¬ 
scribed for the display. 

THE SAMPLE CODE 

Okay class, do you think you can do this 
on your own? Well, if not, we have pro¬ 


vided the necessary routines as part of our 
sample code* We have supplied two key 
functions you can use to select the fonts: 
SelectFont and SelectSc&LableFont. You need 
to provide only the hDC (device context) 
and the hPS (presentation space), and the 
font will be selected for you. 

The method of scaling the scalable 
font is done through the ScaleFont func¬ 
tion. The magic here is to provide the 
necessary point size, which is then 
converted to the device coordinates. 

The function will appropriately 
scale the font for you from the presen¬ 


tation space. All you have to remem¬ 
ber here is that the scaling will remain 
in effect only while the presentation 
space is active. Therefore, if you have 
not created a presentation space 
through the GpiCreatePS function for 
continual use in the window, you will 
have to scale the font each time you 
want to draw with it. 

The simple driver routines that il¬ 
lustrate our APr usage basically show 
the selection of the font for use in a 
window and on your printer. 

One thing to think about is how 
you can improve your applications' 
handling of fonts. You may want to 
cache certain font information away 
once your application has started. 
We will give you a hint here that you 
can do this with the DLL initializa¬ 
tion if you have your font support 
within a DLL. You don't have to 
have a message queue up and run¬ 
ning for it to work. 

UNTIL NEXT TIME 

Now that we know how to select the 
fonts and use them on the display and 
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with | 
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Create applications by customizing visual 
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printer, the question that begs to be an¬ 
swered is how do we ensure that the 
text displayed within the window 
matches that of the printer for word 
breaks and such- We will tackle this 
next time. 

If you want a good book that 
shows some really neat font handling, 
check out Graham Winn's OS/2 
Presentation Manager GPl (either first or 
second edition)* It really has some in¬ 
teresting gems in it. 

Mark Benge, IBM Software Solutions, 
Research Triangle Park , N.C., is a staff pro¬ 
grammer who joined IBM in 1989 and has 
worked on various CUA 91 controls for OS/2 
2.x. He works in IBM user interface ciass 
library development where he was involved in 
the implementation of C++ classes for drag- 
and-drop in C Set++ 2.1. Mark has a B.S. in 
computer science from Western Carolina 
University. He can be reached on CompuServe 
at 73532,2063 and via Internet at 
banzai@vnetibm.com. 


Matt Smith, Prominare inc. t Toronto, Ont. t is involved with OS/2 since 1988 and cofounded fUJ IM 
lead architect for the Prominare Development Prominare in 1990 He has a degree in architec- 

System, an OS/2 2.x advanced GUI develop- tore from the University of Waterloo He can be 

ment environment. Matt has been actively reached via Internet at msmith@interlog.com. 


REFERENCES 

Credits: screen captures were done through OpenShutter from One Up 
Corp. and touched up through PaintBrush in Win-OS/2* 

Special thanks to Michael Perks of IBM's OpenDoc Development Group for 
providing insight into the printer objects* 

You can download PRNT2.EXE from these electronic sources: 

CompuServe's OS2DF2 forum (OS/2 Developer Mag Section)* 

File area 11 on the IBM PCC BBS, (919) 517-0001 

OS/2 Tools section on the OS/2 BBS for IBM TALKLink customers. 

FTP to the side address gold.interIog.com and log in as anonymous. The 
source is located in the /pub/prommare subdirectory. 
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Programming Insider 


There are subtle differences when posting and sending messages in Presentation Manager. This issue's 
Programming Insider shows you when and why to post vs. send messages and how to efficiently 
multithread your programs. By DAVID REICH 


Hey Mr. Postman 



David Reich 


mm rguably the most important issue in 
good multithreaded OS/2 pro- 
M ■ grams today is the user interface 
and how it uses threads. I'm sure most of 
you have at one time or another heard about 
the Presentation Manager single queue. 
Some OS/2 opponents say this means that 
OS/2 is single threaded. This is not quite 
true. 


OS/2 is a truly multithreaded system 
and can process many things at the same 
time, effectively and intelligently moving 



Figure 1. Application initialization. 


things into and out of the processor at light¬ 
ning speed. Presentation Manager (PM), the 
windowing and input subsystem of OS/2, is 
designed to preserve type-ahead and, more 
precisely, user-input-event-ahead in the sys¬ 
tem. As such, all user input in the system is 
funneled through a single system input 
queue. The input router takes the raw event 
data (such as keystroke up, keystroke down, 
and mouse movements) and, based on focus 
information, mouse location information, 
and so on, translates it into what you know 
as PM messages (such as VM.BUTTONIDOYN or 
WM.CHAR). 

The other job of the input router is to 
take these generated PM messages and pass 
them to the application input queues. It is 
important for message ordering integrity 
that the messages get to the windows for 
which they are intended and in the right 
order. If the focus changes, for example, key¬ 
strokes need to be passed to the new focus 
window. This is the foundation for the de¬ 
sign of the single queue. 

This is not to say that the design is in¬ 
herently bad, nor is it to say that it can not or 
should not be changed. The drawback to this 
design is that if an application window (or 
more precisely, the message queue) gets 
messages from the system input queue but 
does not respond to them in a timely way, 
the user interface must hold up processing 
and distributing more user input events until 
the receiving window procedure returns. 
This poses interesting questions in how to 
handle user input in a PM program. The an¬ 
swer is not that tough. 

Your first response (I hope) is to say to 
do the work on another thread. In fact, in the 
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Figure Z Thread procedure for MinPostQueueffsg. 


first PM documents I ever wrote, back 
in 1988, 1 said the same thing. 
However, you can do this in different 
ways. You obviously want to have 
other threads do the work and free the 
user input thread to respond to user 
input events. Should you create a 
thread for each piece of work as it is 
required? Should you create multipur¬ 
pose threads to accept various pieces 
of work? How should you structure 
these threads to be event driven in¬ 
stead of having to poll for events? 
What kind of semaphores should you 
use? Should you even use sema¬ 
phores? In Designing High Performance 
OS/2 Warp Applications, I go through 
all of the rationale and the pros and 
cons of all of the permutations. I also 
discuss how to architect and structure 
the tasks each thread performs. Here I 
will go into the two techniques I feel 
are the easiest and the most robust to 
implement and explain why you need 
to use them. 

UNDERSTANDING ANOTHER THREAD 

Whenever a user event comes in, it 
comes in the form of a PM message. 
The user interface thread (the one that 
executes in the message queue and 
window procedure of your top-level 
window) gets this message off the 
queue and, inside WinDispatchHsg, calls 
WinSendWsg to have the window proce¬ 
dure process the message. The thread 
makes a call into the window proce¬ 
dure as a result of the WinSendHsg and 
drops into the SWITCH statement to filter 
the message and act on it. 

When the appropriate CASE clause 
is encountered (for that specific mes¬ 
sage), the window procedure needs to 
do some work. If it is a simple opera¬ 
tion, such as a beep, pulling down a 
menu, or changing the titlebar, it can 
be done right in the window proce¬ 
dure. If any significant work needs to 
be done, you should ship that off to 
another thread. So what is significant? 

Significant work is loosely defined 
and is more common sense than any¬ 
thing else. If you have a piece of work 
that could potentially hang, such as 
communications with another machine 
over serial or network lines, you 
should do that on another thread. If 
you have to do work that could take a 
long time, such as opening or writing 
to a file or printing, you should do it 
on another thread. If you have to up¬ 
date a database or repaint the window, 
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you should do that on another thread. 
Essentially, anything that is more than 
instantaneous should be done on an- 
other thread, 

WHERE DO THEY COME FROM? 

Where do these threads come from? 
You could, for example, call 
OosCreateThread each time an event re* 
quiring significant work comes into 
your window procedure. The thread 
would execute and then terminate. 
Each time your program needs to do 
work, a thread is started to do it You 
could then keep the thread around and 
not have it terminate in case more 
work is needed to be done, or you 
could just let a new one start each 
time. Once running, you will need to 
look at what happens when another 
message requiring the same work ar¬ 
rives or how to notify the main win¬ 
dow procedure that a piece of work is 
done. 

These ideas should make you seri¬ 
ously wonder how to do this, with the 
incredible number of messages passing 
through PM and the coordination nec¬ 
essary to be able to perform all the 
tasks reliably. Of course you can create 
and manage the life of these threads 
any way you wish, but I will give you 
my recommendations here. 

The first thing is to create the 
threads at application initialization 
time. Looking at the pseudo code in 
Figure 1, you can see that in the main 
body of the program, you will initial¬ 
ize the required data structures and 
then call Winlnitialize. After that, you'll 
create the worker threads (don't worry 
about what they'll do just yet, we'll get 
to that in a moment). After the worker 
threads are there, you can call 
yjjiCreateHsgQueue and WinCreateStdWindow 
and begin to process user input in the 
VinGetflsg / VinOispatc hHsg loop. Note that 
you don't create the main thread's 
message queue until after the threads 
are and just before the main window is 
created. The reason for this is that as 
soon as the message queue is there, it 
is subject to receiving messages. 
Unless the window is there and a 
Get/Oi$patch message loop to receive 
and dispatch the messages is in place, 
you would see unpredictable results. 

Now that you see how to struc¬ 
ture the high-level initialization and 
how to get the worker threads to exist, 
let's look at how they run and how 
you will coordinate execution. 


SYNCHRONIZATION 

You've seen how to initialize the pro¬ 
gram and get the threads started, but 
once they start, what should they do? 
After all, a thread starts to execute a 
(set of) function(s), and when the func¬ 
tion pointed to by the thread finishes, 
the thread naturally terminates. There 
are many ways to manage and coordi¬ 


nate these threads. My preference is to 
have PM do it for you. You could write 
the threads to wait on various event 
semaphores and, when messages come 
into the main window procedure, have 
the response in the CASE clause trigger 
the event semaphore to wake up, do 
the work, and go back to waiting for 
the next event trigger. 
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However, PM does all of this for 
you without you having to worry 
about semaphores* This method also 
provides you with the facility to make 
threads multipurpose. It is not some¬ 
thing new; in fact, it is something you 
use in every PM program; the message 
loop. 

When a thread has a PM message 


queue, it has the use of PM semaphore 
handling and synchronization. The 
way you will use this is that in the 
code that is each of your worker 
threads, you will call Vinlnitialize and 
YinCreateHsgQueue, followed by a 
YinGetHsg loop* This gives you the sema¬ 
phore handling and coordination 
through PM message passing* 
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Refer to the pseudo code in Figure 
2* You can see that in each thread that 
will do work on behalf of the applica¬ 
tion as a result of a message from the 
main window procedure, Winlnitialize 
and WinCreateflsgE)ueue are called to set 
up the appropriate PM structures. 
Following that, you see the familiar 
YinGetHsg call. At this point, you have 
several choices. I will elaborate on two: 
the use of object windows and the use 
of UinPostQueueMsg, Note that Figure 2 
shows what the code would look like 
only for the YinPostQueueHsg method. 

OBJECT WINDOWS 

An object window is a window 
whose parent and owner are HYND.OB- 
JECT. The properties of this window 
Include the fact that it (and hence, its 
children) is invisible and as such 
never receives user input messages. 
You can structure your code to have 
window procedures for windows that 
are children of HVNO_O0JECT. In the USE 
clauses of the SWITCH statement of their 
window procedures, this statement 
does the work you did not want to do 
in the main window procedure be¬ 
cause it executes on the user interface 
thread* You will define messages 
yourself using the yW_USER values and 
post these to these object windows. 

It is important to post the WH.USER 
messages rather than use WinSendHsg be¬ 
cause, as you will recall, WinSendNsg is a 
synchronous operation with respect to 
the originator of the message, while 
WinPostHsg is asynchronous* When 
posted to the object window, the mes¬ 
sage arrives on the target message 
queue, at which time the thread cur¬ 
rently blocked on VinSendKsg is awak¬ 
ened* This is the semaphore handling 
PM gives you when using messages* 

When the thread is awakened and 
the message dispatched to the object 
window's procedure, the CASE clauses 
just described will perform the work 
based on the user input event that 
causes the main window procedure to 
post the message, such as opening or 
reading from a file or painting some 
data in the window on the screen. 

MlnPostQueueNsg 

Another method, which is somewhat 
more efficient, is YinPostQueueHsg. 
WinPostQueueWsg operates fundamentally 
the same way as WinPostHsg, but it does 
not require a window handle* It posts 
a message directly to a queue. 
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When you use YinPostHsg, a win¬ 
dow (more precisely, a window han¬ 
dle) must be there to identify the target 
of the message. YinPostQueueflsg, on the 
other hand, posts the message on the 
queue without the need of that level of 
indirection, relieving you of the work 
(and resource overhead) of extra win¬ 
dows and window handles. 

Refer to Figure 2 again, picking up 
where we left off at the YinGetMsg func¬ 
tion call. You can see where you 
would have an "if ViivGetMsg then 
YinOisp^tchHsg ,, for a window proce¬ 
dure, Here we simply call YinGetMsg to 
block if there are no messages and 
process the SWITCH and CASE clauses if 
there are. Since there is no window 
procedure and no window handle, the 
work is done right there, eliminating 
the overhead of another layer of indi¬ 
rection and of creating windows or 
their associated resource consumption. 

This is the fundamental difference 
between WinPostHsg and YinPostqueueHsg. 
Both are asynchronous with respect to 
the originator of the message, but with 
YinPostQueueMsg, you don't have a win¬ 
dow on top of the queue. 

For YinPostQueueflsg and, actually, 
any PM thread that does not handle 
user input directly, it is important to 
be sure to call WinCancelShutdoMn to en¬ 
sure that the system does not send that 
thread a WH.QUIT message. If the user 
asks to shut down the system, PM 
sends WM_QUIT messages to all PM 
threads. You don't want this to happen 
to your worker threads since they will 
all drop out of the YinGetMsg loops and 
terminate in a possibly random fash¬ 
ion. By calling YinCancelShutdown for each 
of these threads, you can control the 
termination of the threads. 

So, to sum up, the general flow is 
to start up the worker threads early on 
in the application initialization, each of 
which will initialize with PM and then 
block on a call to YinGetMsg. The main 
code then brings up the primary appli¬ 
cation window and, as processing and 
time goes on, messages come into the 
main window procedure and are 
posted to these other threads either via 
YinPostMsg or UinPostQueueHsg, When the 
processing of each message is com¬ 
plete, the thread posts a message back 
to the main window that a job was 
done and goes back to waiting for an¬ 
other message. 

By using these techniques, you 


can create multipurpose threads and 
never have to be concerned with sema¬ 
phores, waking threads up, or when 
threads should block. Best of all, you 
can do this off of the user input thread 
and process all events, user input and 
otherwise, efficiently and without 
holding up events in the system input 
queue. 


David Reich has been with the IBM OS/2 deveh 
opment team since 1987. He has worked on many 
parts of the system , supported customers and 
application developers, and traveled the world 
giving seminars and teaching OS/2. His latest 
book is. Designing High Performance OS/2 Warp 
Applications, published by John Wiley & Sons He 
can be reached on CompuServe at 78711632 or 
via the Internet at speedracenWvnetibm.com. 
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GUI Development 


Presenting a class library for rapid design prototyping with VisualAge. By ANDY CUBBON 


Object-Oriented User 
Interface Design 
with VisualAge 


F or my user interface design projects, 
I needed a tool that could quickly 
prototype the object-oriented user 
interface (OOUI) or graphical user interface 
(GUI) designs I develop for my clients. 
While I still haven't found a tool that is faster 
than the easel charts I use during my interac¬ 
tive joint design sessions, I now use 
AndyCubbon VisualAge to quickly develop a working 

prototype after the session. Frequently this 
can be done in the evening after the work¬ 
shop and demonstrated to the client the next 
day. 



Actually, building the windows and di¬ 
alogs is the easy part Coming up with the 
sample data and putting it in a test database 
can take more than half the time. The key to 
rapid design prototyping is having a library 
of classes that contain the common window 
and dialog structures with their associated 
Smalltalk methods. Over the years, I have 
found that many common menu choices, di¬ 
alog windows, and push buttons can be 
reused from product to product. For exam¬ 
ple, most products need some kind of print- 



Figure F Example of a generaEpurpose Print dialog window , 


positionSizeWindowitX: % at ti y 
"Set the initial window position and adjust 
initial window size to the current system. 

Invoke with iaboutToOpenWidget event. 11 

"Set initial position." 

(self pa rt Attribute Value: #(#'Window' tself)) 
prijnaryVidget i: a asNumber. 

(self partAttfibuteYaiue: 1(1'Window' IselfJ) 
primaryWidget y: y asNumber. 

“Set size of development environment screen 11 

ScreenFunctions developmentScreenWidth: 640, 
ScreenFunctions developmentScreenHeight: 480. 

"Size the window" 

ScreenFunctions size Window: 

(self partHtribute¥alue: I(fWindow Iself)). 

Figure 2. Method (script) in the Vindov class (part) to set 
the initiai window size. 
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ing support. Whether the environment 
supports drag and drop or not, a dia¬ 
log lets the user select a printer or di¬ 
rect the printing to a file as needed, as 
illustrated in Figure 1. 


ADJUSTING WINDOW SIZE 
TO SCREEN SIZE 

The first design prototype 1 did took 
me about 16 hours. This included de¬ 
veloping most of the standard win¬ 


size*Window: aWindow 

"Size the argument window proportional to the current 
screen size based on the development screen size. 

Invoked by the IpositionSizeWindowAtXratY: method." 

| windowWidth windovHeight ratio | 

"Ensure argument is a VisualAge window" 

(aWindow class inheritsFrom: AbtBasieView) 
ifFalse: [self error: 

'#$izeAWindow argument is not a visual part/]. 

"Intialize the class variables if necessary" 

(CurrentScreenWidth isNil) 

if True: [self initialize], 

"Get the Width and Height of argument window" 

windowWidth ; s (aWindow primaryWidget width) asFloat. 
windowHeight ;= (aWindow primaryWidget height) asFloat. 

"Calculate screen size ratio. Assumes that the ratio is 
the same for the width and height." 

ratio ({CurrentScreenWidth asFloat) 

/ 

(DevelopmentSystemScreenWidth asFloat)), 

"Adjust ratio based on experiments of VGA to XGA 
and XGA to VGA/ 

"VGA to XGA" 

(ratio = (1024 asFloat / 640 asFloat) ) 
ifTrue: [ratio := 1,3], 

"XGA to VGA" 

(ratio = (640 asFloat / 1024 asFloat) ) 
ifTrue: [ratio := 0.851, 

"Compute new window size based on the ratio of 
the current screen to the development screen" 

windowWidth (ratio * windowWidth) aslnteger. 
windowHeight : s (ratio * windowHeight) aslnteger. 

"Set the new window size" 

aWindow primeryWidget width: windowWidth. 
aWindow primaryWidget height: windowHeight, 


Figure 3 . This is a class method used to set the initial window size. 


dows as well as the product-specific 
windows. The prototype also had to 
run on both VGA and XGA displays. I 
spent most of the time attaching the 
controls together and developing the 
methods (scripts)' to set the initial win¬ 
dow size so the prototype windows 
would display appropriately at the dif¬ 
ferent resolutions. Now that I have in¬ 
cluded these methods in the Window 
class of my prototype library, they are 
inherited by the other classes in the li¬ 
brary as well as new design prototype 
windows using the library classes as 
parents. All I need to do is specify the 
initial position of the new window. 

Figure 2 is a method in the Window 
class that sets the initial position and 
size of the window. It sets two class 
variables of ScreenFunctions (a nonvisual 
part in the prototype library) with the 
development system screen size and 
uses the *sizeAWindow method of 
ScreenFunctions (Figure 3) to set the ini¬ 
tial size of the window to be propor¬ 
tional to the execution environment's 
screen size. 

These methods and the others in 
this article are available in a file named 
CUBBON.ZIP in the CompuServe 
OS2DF2 forum library, OS/2 De¬ 
veloper Mag section. 

Figure 3 is the method in 
ScreenFunctions to set the initial window 
size proportional to the screen size. It 
calculates the ratio of the current sys¬ 
tem screen width to the development 
system screen width. This ratio is used 
to adjust the initial size of the window. 
The ratios for XGA to/from VGA were 
determined by experimentation to get 
the resized window to display well. 
Note that the finitialize method only 
sets the development system class 
variables if they have no value (are 
nil). Since they are set by the method 
in Figure 2, they are not changed by 
♦initialize. 

THE PROTOTYPE CLASS LIBRARY 

Figure 4 shows the class hierarchy for 
the prototype library. The Window class 
inherits from the standard Visual Age 
visual class (part), AbtAppBldrView. Window 
is an abstract class. Design prototypes 
do not create instances of Window or use 
it as the parent class. Instead, classes 
built for the design prototype would 
inherit from or be instances of the ap¬ 
propriate subclasses of Window. 

PrimaryWindow is used as the parent 
class for a details view of a container 


26 


OS/2 DEVELOPER 



window and the main window used to 
display an object. It is a window with 
standard menu bar and pull-down 
choices and standard dialog and sec¬ 
ondary windows. The design prototype 
primary windows are tailored to in¬ 
clude the appropriate controls and non¬ 
visual classes (parts) for the object or 
container. For example, a database 
query and connected table controls are 
added to the details container view* The 
appropriate menu choices are created 
by deleting those that are not needed 
and adding any design-specific choices. 

The PrimaryWindow menu choices that 
display dialog windows use those pro¬ 
vided in the prototype library* There¬ 
fore, if the prototype library windows 
meet the design prototyping require¬ 
ments, no changes need to be made. 
This includes sample help windows. 

If the design requires variations of 
a prototype library dialog, a new win¬ 
dow is created using the appropriate 
prototype library class as the parent 
An instance of the new dialog window 
is put in the composition area, and the 
connections are moved from the li¬ 
brary instance to the new one* Once 
the new window works properly, the 
library instance is deleted. 

HELP WINDOW 

The prototype help window (Figure 5) 
is intended to illustrate how the help 
would work rather than be a true help 
system. Therefore, to save prototype 
development time, it does not use the 
help support provided by OS/2. Nor 
do any of the standard actions, such as 
Search or Index, work. 

A method in the Window class of the 
prototype library (Figure 6) displays 
the help window. This method takes 
two arguments. The first argument is a 
string used as the title of the help win¬ 
dow. The second argument is the 
name of an ASCII file used by a 
Help Window method to provide the con¬ 
tent of the help window. The argu¬ 
ments for invoking a help window are 
typically provided as parameters in 
the Settings of the event-to-script con¬ 
nection for the help actions. If a file 
name is not provided (the argument is 
nil), the method in the HelpWindow class 
(Figure 7) displays the default message 
shown in Figure 5. 

PRODUCT INFORMA TION WINDOW 

The Product Information window 
(sometimes called the About window) 


illustrates this function of this Help 
menu choice. It should be tailored to the 
prototype by including tire name of the 
product and the author of the design 
prototype. Create a new visual class in 
the prototype application that inherits 
from ProductlnfornationWindou and change 
the appropriate labels and icons* Add 
the new Product Information window to 
all primary windows. Drag the connec¬ 
tions from the library Product Infor¬ 
mation window to the new one, test it, 
and delete the old window. 


DIALOG WINDOW 

The generic dialog window is used as 
the parent class for the other standard 
dialog windows in the prototype li¬ 
brary as well as the parent for any ap¬ 
plication-specific dialogs that are 
needed by the design prototype. It 
contains the standard Cancel and Help 
push buttons along with a push button 
to perform the main action of the dia¬ 
log. It also contains the generic exam¬ 
ple help window, which can be dis¬ 
played by pressing either the Help 


Window 

1 

1 1 1 

! 

PrimaryWindoa DialogVindow HelpWindow 

, 1 

ProductlnformationWindow 

1 1 

PrintWindow IncludeWindow 

, 1 


1 1 
FindWindow SortWindow 



Figure 4 . Prototype library class structure. 



Figure 5. Prototype Help window 


helpYithTitle: titleString InFUe: fileflaroeString 
"Display generic Help window." 

self partAttributeValue: #{fWindowJ(elp #HelpTitle) 
put; titleString. 

self parilttributeValue: #(i'Window.Help'' IHelpfile) 
put: fileNameString. 

(self subpartNamed: tVindou.Help) performActionNamed: 

#openWidget* 

Figure 6, Method in the Itindou class used to display a generic help window ; 
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push button or FI. 

As with the Prjjnarytfindm# class, to 
create a new dialog window for a pro¬ 


totype, create a new visual class using 
DialogVindcw as the parent class. Add the 
needed controls, change the title and 


action push-button text, and even add 
an additional push button or two if 
needed. 

PRINT WINDOW 

Figure 1 illustrates a model for a Print 
dialog window* The radio buttons let 
the user select where to direct the 
printing* If Printer is selected, the user 
can select a printer from the drop¬ 
down list* Using a drop-down list lets 
the product populate the list with the 
available printers at installation time 
or even at run time. If File is selected, 
the user can enter a file name or select 
one from the list boxes. Only the ap¬ 
propriate controls are active for each 
radio button. 

When the Print window needs to 
be tailored for a specific design, create a 
new class as a subclass of Pri/vtltindow and 
make the desired changes. For instance, 
an additional option for directing the 
printing to a fax modem can be added. 
Add another radio button and an entry 
field for the phone number* Copy the 
method that interprets the radio buttons 
from the parent class and enhance it to 
handle the new radio button. 

INCLUDE WINDOW 

The Include choice in container win¬ 
dows allows users to filter the objects 
displayed to include only those that 
meet certain criteria. Figure 8 shows a 
simple Include dialog window that lets 
users specify values for up to three 
columns as their criteria. The column 
selection uses a drop-down list that 
provides users with flexibility in their 
filtering criteria* It also allows the ap¬ 
plication to provide the values at run 
time, enabling this dialog to be used 
for any container. 

The Include dialog can be en¬ 
hanced to allow users to OR the crite¬ 
ria as well as AND them, for example, 
"Last name = Smyth" "or" "Last name 
= Smith/' Additional comparison op¬ 
erators such as less than, greater than, 
and not equal to can be added by 
using a drop-down list of operators. 
Increasing the flexibility of the Include 
dialog adds additional programming 
effort to the actual product and may be 
impractical when the criteria is used to 
generate database queries. 

FIND WINDOW 

The Find choice in container windows 
allows users to locate objects in the 
container. The Find dialog is similar in 



Figure 7. Method in the HelpVindov class used to determine if a fife name is passed. 



Figure ft Include dialog window. 



Figure ft Sort dialog window. 
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appearance to the Include dialog. The 
only appearance differences are replac¬ 
ing the word Include with Find in the 
titlebar and first push button. 

Again, this window can be made 
more flexible by adding OR and pro¬ 
viding additional comparison operator 
choices, 

SORT WINDOW 

Users can also sort objects in a con¬ 
tainer. Figure 9 is a general Sort dialog 
window. It is similar in appearance to 
the Include and Find dialogs by allow¬ 
ing users to select the columns to sort 
from drop-down lists. Instead of com¬ 
parison operators and an entry held, it 
gives the user a choice of sorting in as¬ 
cending or descending order for each 
column. 

These prototype Include, Find, and 
Sort windows just illustrate the dialogs 
in a design prototype of the interface. 
For the actual application, significant 
additional Smalltalk programming and 
database access elements would have to 
be added to do the actual filtering, lo¬ 
cating, and sorting. 

FUTURE ENHANCEMENTS 

This is beginning rapid design proto¬ 
type class library in VisualAge. More 
objects will be added as they are 
needed in designs. Some candidates 
under consideration are standard mes¬ 
sage boxes. Unfortunately, the mes¬ 
sage box support in VisualAge does 
not have enough flexibility for all situ¬ 
ations. Specifically, I plan to develop a 
standard message dialog that is dis¬ 
played when a user does not save 
changes to an object and takes an ac¬ 
tion that would cause the changes to 


be lost. This message needs Save and 
Discard buttons, which are not pro¬ 
vided by VisualAge message boxes. 

1 am also planning to develop a 
standard Look Up dialog that is dis¬ 
played for selecting valid values for a 
field. A Look Up dialog is used when 
there are too many valid values to dis¬ 
play in a drop-down list or list box and 
the users need to be able to search the 
values for the one they want. The Look 
Up dialog window would be similar to 
the Find dialog window with the addi¬ 
tion of a list box to list the choices 
found, 

Andy Cubbon was part of the IBM Dallas 
Open Systems Center before leaving to set up 
his own business. User Interface Design Inc. He 
is a user interface design architect who has 
been doing user interface designs and reviews 
for clients for six years. Andy can be reached at 
(404) 971-8552 or via e-mail at 
75357.241(^CompuServe. com. 
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1. To be consistent with other GUI 
tools, VisualAge uses the terms 
"part" and "script" instead of 
"class" and "method." I use the 
Smalltalk terms here. 
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P resentation Manager windows com¬ 
municate using a queue message 
processing system. All windows in 
a Presentation Manager thread share a single 
message queue for processing messages; 
however, all message queues are descen¬ 
dants of the Presentation Manager system 
message queue. This is the reason that one 
poorly designed Presentation Manager ap¬ 
plication can freeze up the entire system The 
queuing mechanism is an important concept 
to understand. 

Once a window has a message queue, it 
can communicate with any other window in 
the entire system. All it needs is the window, 
or message queue, handle to send the mes¬ 
sage to. 

A window can send or receive messages. 
Each message is used to signal some sort of 
event. Each time a mouse is moved, a win¬ 
dow is resized, or a menu item is selected, 
messages are sent to a window. A window 
procedure operates like a massive sieve, fil¬ 
tering the messages of interest and passing 
through those messages that are unimpor¬ 
tant. It is important to realize that all mes¬ 
sages must be processed and replied to, ei¬ 
ther through your own window procedure or 
by passing the message to WinQefWindowProc or 
WinDefDlgProc. This facility of using events to 
control the programming flow is known as 
event-driven programming. This style is 
common to not only Presentation Manager 
programming but other GUI programming 
environments as well. 

MESSAGE ORDERING 

It is not a good idea to count on messages ar¬ 
riving in your message queue in a certain 


order. The purpose of event-driven pro¬ 
gramming is to be flexible and dynamic and 
respond only when asked; however, there 
are obviously times when it is important to 
understand the flow of messages the system 
sends to your queue. 

The first message you can count on 
being sent to your client window is the 
WH_CREATE message. At the time this message 
arrives, the window handle exists but has no 
size and is not visible. The MN_CREATE message 
can be used to do some application-specific 
initialization, such as allocating memory for 
window words. Any queries specific to size 
or focus, however, should be done after cre¬ 
ation. One way to accomplish this is by post¬ 
ing a user-defined message to the client 
window in the WH_CREATE processing. The size 
and focus messages the system places in the 
queue are sent messages and will be 
processed before a posted message. When 
you process the user-defined message, you 
will have a client area that has both size and 
focus, and this information can be used in 
any initialization that needs to be done. 

The standard way to set size or focus is 
by using the respective APIs directly after 
the WinCraateStdUindoi or WinCreateWindow call. 
You can change the size or position of a win¬ 
dow in two ways. The first way is to create 
the client window as not visible and then use 
the function WinSetWindowPos to size and show 
the window. The second method is to inter¬ 
cept the WMDJUSTyiNQOVPOS message. This 
message is sent before a window has been 
sized or moved. This gives the application a 
chance to override the new size and position 
with a size and position of its own choosing. 
If modifications are made, the application 
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should return TRUE instead of FALSE, and the 
new coordinates are used. 

FOCUS MESSAGES 

When a window is gaining or losing focus, 
several messages are sent by the system. It is 
not advisable to process any of these mes¬ 
sages yourself, but it is useful to understand 
how Presentation Manager handles chang¬ 
ing a windows focus. 

When a user clicks the mouse on an¬ 
other window, the system first sends a set of 
messages to the window that is losing the 
focus. A set of WH_QU ER YFOCUSCH A IN messages are 
sent to the frame window and its children to 
help the system decide which windows will 
be involved in this focus change operation. 
Next, a WM_ FOC USCHA NGE message is sent to both 
the frame and its children to indicate they 
are all losing focus. The next message sent is 
the W«_SETFQOfS message. This message indi¬ 
cates the window is either about to lose or 
about to gain the input focus. In this case, it 
would be losing input focus* Next, the 
yM_SETSELECTION message is sent This message 
is used to unhighlight or highlight any se¬ 
lected items In the window. The client area 
does not do much with this message, but it is 
at this time that the titlebar window changes 
from a highlighted titlebar to an unhigh¬ 
lighted titlebar. The last message sent when 
a window is losing focus is the IfH_ACTIVATE 
message* The message actually takes away 
the focus from the active window. 

When a window is gaining focus, the 
messages are sent in a similar fashion. First, 
the system queries the windows with the 
WM.QUERYFOCUSCHAIN. Then, a VM.FOCUSCHINGE mes¬ 
sage is sent to the frame and its children to in¬ 
dicate they are gaining focus. Next, the focus 
change operations are actually performed, 
with a WW_SETFDCUS being sent first, then the 
WH.SETSELECTIDN, and lastly, the UM JCTTYATE. 

SIZE AND PAINT MESSA GES 

An application receives three messages 
when a window is sized, WR.CALCYALIDRECTS, 
M^SIZE, and U^PAINT, The message VNJTALC- 
YALIDRECTS is used to communicate the new 
window size and coordinates after the sizing 
operation. The WM_CALCVALIDRECTS is used only 
when CS.SIZEREORAy style is not specified since 
the whole window will be invalidated when 
a sizing operation is done on a window with 
this style. 


The next message is the WH.SIZE message. 
This message gives the application a chance 
to reposition any other window that may be 
dependent on the newly sized windows po¬ 
sition* The last message passed, if the style 
CS_SIZ ERE DR AW is set, is WH.PAINT, If the YS.Srk- 
PAINT style is set, the message will be sent, 
otherwise the message will be posted. The 
system will pass the rectangular coordinates 
that contain the area to be redrawn as a para¬ 
meter in the WM.PAINT message, 

THE LAST MESSAGES A WINDOW RECEIVES 

When a WM_CLDSE message is posted to a win¬ 
dow' (when the user selects CLOSE from the 
system menu), a VH.STSCQMMANO message is 
posted with the SC^CLQSF ID. Next, a WM_QUIT 
message is posted to the message queue. 
This is a very special message because when 
VinGetMsg receives it, the function returns 
FALSE, causing the YinGetflsg/yinDispatchHsg 
loop to terminate. A VH_SAVEAPPLICATION mes¬ 
sage is posted next. This gives the applica¬ 
tion a chance to prompt the user for any last- 
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Thread Blocks 
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Thread A 


-- * 

Thread unblocks and 
continues 


Figure 1. VinSendNsg in a multithreaded application. 
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minute cleanup work, such as saving a 
file or disconnecting a communication 
line. When WinDestroyWindow is used to 
destroy the frame window, the system 
will send the focus change messages to 
indicate this frame window and all its 
children will be losing focus. The last 
message a window will receive is VM_DE- 
STROt, This is the place to control any ap¬ 
plication-specific cleanup. For example, 
freeing memory should be done in the 
UOESTROY processing. 

When the user has selected 
"Shutdown" from the desktop menu 
or the Warp Launchpad, there is a little 
change in the messages that arrive in 
the queue. The system bypasses the 
WMJXOSE message and sends two mes¬ 
sages to each thread that contains a 
message queue. The first is the 


WH.SAVEARPLICATION, The next message is¬ 
sued is the VH_QUIT message. An applica¬ 
tion will usually not process the VPLQUIT 
message; however, in the case when it 
needs to interrupt or halt system shut¬ 
down, it must process WH JJUIT, If the ap¬ 
plication wants to cancel the shutdown, 
it can call WinCancelShutdown. If the appli¬ 
cation would like to do something else 
before shutting down, it can perform its 
closing work and then call WinDestroy- 
MsgQueue. After processing, make sure 
you return FALSE implicitly, and do not 
call WinDefWindowProc as the default win¬ 
dow procedure does not know how to 
handle a tfM_QUTT message . 

GOTCHA! 

For each thread that contains a mes¬ 
sage queue, make absolutely sure you 
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issue a WinCancelShutdown soon after the 
thread is created if you do not want to 
process the WM_QUIT, or else be prepared 
to process the WMUU message and de¬ 
stroy the message queue. A thread 
with a never-ending message queue 
can prevent the entire system from 
shutting down properly. Also, there is 
no guarantee that a secondary thread 
will execute all function calls and re¬ 
turn before the primary thread (and 
thus the application) exits, tt is up to 
the developer to make sure all cleanup 
in secondary threads is complete be¬ 
fore the application exits. 

SENDING MESSAGES 

When a message is sent, it is usually 
directed to a particular window. For 
instance, a WM.CHAR message indicating 
a key had been pressed would be sent 
to the window' that was currently ac¬ 
tive and had the keyboard focus. 
Messages can be dispatched in two 
ways. They can be either sent, using 
WinSendMsg, or posted, using WinPostHsg. 
There is a very subtle difference be¬ 
tween these two dispatch methods, 
and this could cause you problems 
somewhere down the road. When a 
message is sent, it is not put in a win¬ 
dow's message queue; it is processed 
the next time WinGetMsg is called or im¬ 
mediately executed if no message is 
currently being processed. The thread 
containing WinSendHsg blocks, and con¬ 
trol is switched over to the thread 
containing the receiving message's 
window procedure. 

A message should be sent when it 
absolutely, positively has to be there 
right now. A good example of this is 
passing pointers in messages when 
there is no guarantee that the pointer 
will point to something valid when the 
message is up for processing, WinSendHsg 
should be used in this situation. 

GOTCHA! 

One little bit of information about 
VinSendMsg: this function will not return 
until that message has been processed, 
Yup, that's right. If you send a mes¬ 
sage from your window procedure to 
a window procedure that's asleep at 
the wheel, or even just a little slow to 
respond, your window procedure will 
sit there and w-ait until it gets some re¬ 
sponse back from the other window 
procedure. If you send a message to 
some window for which the system 
controls the window procedure, you 
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can pretty much guarantee a zippy re¬ 
sponse, However, be careful when 
using this function to send messages to 
either your own window procedure or 
to some other application's window 
procedure, WinPostHsg is a much safer 
method of transmitting messages, al¬ 
though the message is placed into the 
receiving window's message queue. It 
will be processed when that window 
gets around to it. YinPostMsg should be 
used when you want to communicate 
some information and do not care 
about a reply. VinSendHsg should be 
used when it is imperative that you 
gain some piece of information and 
have to respond to it now, 

BROADCASTING MESSAGES 

A window can communicate one on 
one with another window directly, or 
it can broadcast a message to several 
windows at once. The function: 

yinBroadcastMsg( HWND hund, ULONG ulAsg, 

HP ARAN mpl» mm fflp2 f ULONG ulCmd ) 

can be used to send or post a message 
to the windows specified in the ulCmd 
parameter. This command contains 
two parts: with whom to communicate 
and what form of communication to 
use. These flags are then ORed to¬ 
gether. The default communication 
form is BMSG_P0ST. You can specify 
BHSG.PQST, BHSG.SEND, or BNSG.POSTQUFUE. 
The POSTQUEUE flag will post a message 
to all threads in the system that have a 
message queue, and the found parameter 
will be ignored. Only one of these 
three flags can be specified. The sec¬ 
ond part of the ulCmd parameter indi¬ 
cates with whom to communicate. The 
choices are BHSGJJESCENDANTS or 
BHSG.FRAHEONU, DESCENDANTS will commu¬ 
nicate with found and all of its descen¬ 
dants. FRAHEDNLY will broadcast a mes¬ 
sage to all frame windows that are 
descendants of hund. To broadcast to all 
frames in the system use «YNIL DESKTOP 
for hund. 

PEEKING INTO THE MESSAGE QUEUE 

In many instances, you do not want to 
retrieve a message from the message 
queue but instead would rather just 
peek into the queue and see if a mes¬ 
sage is waiting. The function: 

VinPffflkHsgt HAB hab, PQNSG pqmsg, HUND 
hund, ULONG lOFirst, ULONG uliast, ULONG 
ulOptions) 


inspects the message queue and re¬ 
turns information about the queue, 
found narrows the search to a specific 
window or its children. The ulFirst 
and uILast parameters let you narrow 
the search even further to a numerical 
range. If both these parameters are 
null, all messages are included in the 
search. The ulOptions flag indicates 
whether the message is removed from 
the queue or not. The default is to not 


remove the message from the queue. 
The return from this function indicates 
whether the search was successful or 
not. Table 1 shows the several func¬ 
tions that query information from the 
message queue, 

MESSAGE PRIORITIES 

When messages are retrieved from the 
message queue, they are not necessar¬ 
ily retrieved on a "first in, first out" 


You're looking at a 
Rocky Mountain Bighorn 
Sheep. But no one calls 
this bighorn sheepish. 
He's intelligent he's 
energetic, and he thrives 
on being at the top. He 
knows he'll have to butt 
heads with some 
powerful challengers, so 
he is always well 
prepared for fierce 
competition. 



If you are an OS/2 
programmer who has 
escaped from the 
sheepish flock* you 
already know you cannot 
miss Colorado S/2. But 
don't hesitate - space is 
tormtedi and you can't 
afford to wait for 
anodh&r Whole year. In 
face. that would be very 
baaaad! 

Plan now to 
attend the 4th 
International 

ColoradOS/2 

m 


^ Coioi adOS/2x 


OS/2 software developers have 
refused to join the "everybody 
follow me" flock. They won't 
tolerate having their vision limited 
by the south end of their closest 
competitors. Or having everyone's 
vision limited by a self-appointed 
leader. Then ending up fleeced. 

And every Fall, the best OS/2 
programmers in the world gather 
in the Colorado High Country, for 
a week of intense OS/2 
programming information 
exchange. Mingling with OS/2 
gurus and gifted newcomers* 
eagerly sharing their knowledge* 
making lifelong friends and 
tapping into a worldwide network 
of people all committed to 
excellence. 


October 15- 
October 20,1995 

Keystone Conference 
Center 

Keystone,Colorado 

To register or for information call: 
(800) 481-3389 US & Canada 
(719) 481-3389 International 
(719) 481-8069 FAX 
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Function 

Description 

VinQueryMsgPos 

Returns the pointer position when the last message 
retrieved from the queue was posted. This is the pH 
parameter in the QMSG structure* 

VinQueryMsgTinve 

Returns the time in milliseconds when the last message 
retrieved from the queue was posted. This is the Urn 
parameter in the QMSG structure. 

WinQueryQueuelnfo 

Returns the HQBIFQ structure* This structure includes 
the process ID, thread ID, and message count* 

MiflQueryQueueStatus 

Returns information about what types of messages are 
in the queue* 


Table t Finding more message queue information 


The default window style causes 
Presentation Manager to group invali¬ 
dated regions together and generate 
one MM.PAINT message* The window 
style, WS.SYHCPAINT, or the class style, 
C$_SYNCPAINT, will stop Presentation 
Manager from behaving in this inde¬ 
pendent manner. And each time a re¬ 
gion is invalidated. Presentation 
Manager will very obediently call the 
MM_P*INT processing immediately by 
sending the WR.PiUNT message* The sys¬ 
tem does not post this message; it 
jumps to the MM_PAIIiT processing, and 
then, when painting is completed, 
jumps back to the call following the re¬ 
gion invalidation. 


basis* Instead, messages are retrieved 
on the basis of priority, similar to 
threads. Following is a list of messages 
in the order they will be retrieved: 

* Sent messages 

* WH_SEM1 

* All other posted messages 

* Keyboard or mouse messages 

* mjm 

* VM_ PAINT 


• UH.SEM3 

• MM.TIMER 

• MM.SEK4. 

Figure 2 represents a flow chart of 
how messages are retrieved. 

You may be wondering. What are 
these VR_SEM messages, and what is the 
VHJTMER message? Well, on to the next 
topic*.. MM .PAINT messages are fairly low 
on the message priority totem pole. 


MESSAGES AND SYNCHRONIZATION 
OF EVENTS 

Often an application wants to know 
when some event has occurred. One 
way to do this is by using the 
MM.SEMl,2,3,4 messages. These messages 
are totally for your application use. If 
they are passed to VinDefWindowProc or 
UinDefDlgProc, it has no effect on the sys¬ 
tem* For example, suppose you have a 
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worker thread that has finished pro¬ 
cessing. That thread could post a VH_SEH2 
to the main thread to indicate that the 
thread has finished its work, VH_5EHi 
messages should really be reserved for 
very important, time-critical events. 

A way to keep track of an event 
that is dependent on some function of 
time is to use the functions 
HifiStartTimer and VinStopTimer. 
VinStartTimer starts an alarm clock that 
is set to go off after some applicatian- 
defined amount of time, in millisec¬ 
onds. When the timer goes off, the sys¬ 
tem sends a WHJTMEft message back to 
your window procedure. 

You might consider using sema¬ 
phores in a window procedure. 
DON'T!! Instead, think of using 
VinfiequestMutexSem, MinVaitEventSem, or 
VinVaitHuxVaitSeiiL Waiting on a sema¬ 
phore using the regular DosWait*, .Sem 
functions can bring a window proce¬ 
dure to a screeching halt. Even the 
most well-behaved semaphore syn¬ 
chronization can develop a mind of its 
own every now and then. The special 
set of window semaphore functions 


were created to provide the same func¬ 
tionality as the DosVait,, .Sem functions 
but not to interrupt the flow of your 
window procedure completely. The 
system will appear to wait in the mes¬ 
sage processing that this function is 
called from, but messages sent to the 
message queue will be processed syn¬ 
chronously* When the semaphore has 
been posted or the function times out, 
the message processing resumes where 
the Winyait. . . call was executed. Note 
that messages that are posted will re¬ 
main in the message queue until after 
the Uiayait., * call has completed* 

USER-DEFINED MESSAGES 

Presentation Manager also gives you 
the flexibility to add your own mes¬ 
sages to the system. These are called 
user-defined messages and are numer¬ 
ically represented by the range 0x1000 
through QxBFFF. Some system-defined 
messages fall into this range: UM_USER+40 
through WH_ti$Eft+55. This is an area that 
may change in the future, so it's a 
good idea to search through the 
Toolkit header files to see if there are 


any new messages defined that fall 
into this range. Several examples in 
this book use user-defined messages* 
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k^£v/l Object-Oriented Programming 

Recent additions to the C++ language now allow developers to reach for a new level of robustness in 
their software. Of these. exceptions are one of the most powerful. But their optimum use entails a 
radical new approach to application architecture. By DEAN RODDEY 


Writing Exceptionally 
Robust Software 



Dean Roddey 


mm s more OS/2-based companies 
move beyond the stage of OOWT 
JT 1 {Object-Oriented Wishful Think¬ 
ing) and start to implement or port their 
systems to C++, they need to understand 
what C++ offers. In this article I will try to 
shed some light on a particularly powerful 
C++ tool, exceptions, and how to use them 
effectively. 


PREREQUISITES 

This article assumes a working knowledge of 
C/C++ syntax and at least a basic knowl¬ 
edge of object orientation. You might also 
want to read "An Exception You Can 
Handle" {OS/2 Developer , January/February 
1995) for a discussion of OS/2 system excep¬ 
tions. It will give you some perspective on 
the differences between C++ exceptions and 
OS/2 exceptions. C++ exceptions are similar 
in concept but quite different in impact and 
power. C++ exceptions are defined by the 
language {as opposed to the operating sys¬ 
tem) and are, therefore, platform indepen¬ 
dent and object savvy. 

ROBUST SOFTWARE 

A big problem in software today, as every¬ 
one knows all too well, is that it is not terri¬ 
bly robust. We would all like to write manly, 
hardened. Old Spice-wearing software that 
never shows its sensitive side, but it seems to 
elude us. Of course, many people see C++ as 
anything but robust, being just a more dan¬ 
gerous version of C. 1 would attribute this at¬ 
titude to an outmoded antipathy toward all 
things C. But recent additions to the C++ 
language, such as RTTI, templates, and ex¬ 
ceptions, have made this view even more 


questionable. Of these additions, exceptions 
are among the most powerful tools we have 
now to create robust software. After recently 
converting all of my code to an exception- 
driven architecture, T can personally attest to 
the power of this tool 

UNDERSTANDING STACKS 

To understand exceptions, you must under¬ 
stand the stack concept. Under OS/2, each 
thread has its own stack. When a thread calls 
a function or method, a number of things 
happen on the stack, as shown in Figure 1. 
Before the call, the compiler will push the ar¬ 
guments that are going to be passed. The 
order and format generally depend upon the 
language and the compiler. The compiler 
then pushes the address of the next instruc¬ 
tion after the call and jumps to the func¬ 
tion/method entry point. On entry to the 
function, the compiler will save the stack 
pointer in the page frame register and then 
move the stack pointer down far enough to 
make room on the stack for the automatic 
variables. This underlying magic happens 
(with some small variations) regardless of 
the language or compiler. 

So automatic variables are just a blob of 
space on the stack of the calling thread. This 
is why multiple threads can call into a func¬ 
tion and not step on each other's automatic 
data toes. And it means that the compiler, on 
exit from the function, can magically wipe 
out all of that data just by restoring the 
saved stack pointer from the page frame reg¬ 
ister. The data is still there on the stack, it is 
just ignored now and will be overwritten by 
the next call. There is no need for the over¬ 
head of allocation or deallocation since the 
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space is already there an the stack, as illus¬ 
trated in Figure 1. The compiler then issues a 
RET statement, which causes the CPU to pop 
the return address off the stack, and returns 
to the instruction following the original call. 
At that point, C programs will clean off the 
pushed parameters. Other languages allow 
the called function to do that. 

That is all well and good, but there is 
one major shortcoming. Exiting the function 
does nothing more than move the stack 
pointer. This is fine unless one of those local 
variables is a resource handle or a pointer to 
some dynamically allocated memory. In 
such cases, the called function is responsible 
for cleaning up such resources before the 
pointer or handle goes out of scope. Making 
sure that all dynamically allocated resources 
get cleaned up means that either you bend 
over backwards to have a single function exit 
(that is, make it very nested) or you make 
sure that the cleanup is done from every re¬ 
turn point. Failure to do this is a prime 
source of resource leaks, the bane of robust 
software (made worse by the fact that they 
don't show up until the program has run for 
some time), 

C++ is much smarter about this situa¬ 
tion. It will call the destructor of any objects 
that go out of scope. For an automatic ob¬ 
ject, this occurs upon exiting the function or 
the block in which it was declared. This 
means that, given a fully object-oriented ar¬ 
chitecture in which all resources are 
wrapped in classes, resource leaks of this 
type can be totally banished with minimal 
effort Every object will be given a chance to 
clean up its resources regardless of where 
or how the function is exited. This single 
concept makes C++ orders of magnitude 
more robust. 

For those occasions where you must dy¬ 
namically allocate automatic objects, you can 
use the janitor concept to handle resource 
cleanup. Figure 2 shows the class definition 
of a janitor. It is incredibly simple and totally 
inline for good performance, although this 
example assumes a single-rooted system. 
The janitor's constructor is given a pointer to 
a dynamically created object. When the jani¬ 
tor goes out of scope, its destructor will be 
called, which will delete the object it is con¬ 
trolling. I have to admit I stole the janitor 
idea from Taligent, though I doubt the peo¬ 
ple there invented it either. 


EXCEPTIONS 

Now we can finally talk about C++ excep¬ 
tions. Exceptions are thrown and caught. 
They are thrown to report an error and 
caught to handle the error. C++ exceptions 
"unwind" the stack. This means that at the 
point where the throw is done, it is as if an 
implicit return statement was done. 
However, this return traces its way back out 
from each block of code, which includes 
loops, if blocks, functions, and so forth, 
looking for a catch block on the stack. In 
each block, if no catch is found, any auto¬ 
matic objects created at that level are de- 
structed and the search continues. If there is 
no catch in the function, all of the top-level 
automatic variables are destructed and the 
function returns to the caller. The search 
continues there and so on. If no catch is 
found, it will eventually hit the run-time li¬ 
brary and the process will be terminated. 
(C++, unlike C, allows you to declare auto¬ 
matic variables within any block of code. 
The exception destructs each block's objects 
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as it searches upward,) 

Here is a list of important rules 

about C++ exceptions; 

* Exceptions are based on the type of 
the thing thrown. For the most part, 
only objects are thrown, though fun¬ 
damental types can also be thrown. 

* Any thrown objects must have a 
valid copy constructor. 

* You can have multiple catch{} blocks 
after a throw. The first one that 
matches exactly or can be converted 
via standard conversion rules or 
conversion operators will be taken. 
The others will be ignored. So put 
the most specific types first, fol¬ 
lowed by more general ones. 

* Any unhandled exception will be 
handled by the run time and will 
terminate the application. 

* The statement catch (...) will catch 
anything and can be used as the last 
catch block to handle anything weird 
coming along. This should not be 
required if the following strategies are 
used, though the highest-level code 
might use one during debugging. 

* Inside a catch{> block, you can just 
type throw; to rethrow the exception 
after you have handled it, assuming 
you want it to propagate up the 
stack. This is preferable to actually 
rethrowing the caught object explic¬ 
itly because that might slice the 
object (Figure 3). 

* Don't throw an exception within a 
destructor (or call anything that 


class JANITOR 

{ 

public : 

JANITOR(OBJECT* pobjToDestray) : 

_^pobj T oD estro y(pobj ToDest roy) 

{ 

> 

-JINITORO 

{ 

delete __pobjToDestroy; 

} 

private : 

OBJECT* pobjToDestroy; 

>; 

Figure Z Your very own personal JANITOR will 
clean up dynamically allocated data on your 
behalf. It may not be politically correct , but 
SUHnumNENGINEFR was a little long for a type 
name. 



Figure 3 r An example of a relatively raw use of exceptions to handle the cleanup of nonobject 
dynamically allocated resources. 
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might) unless you catch it within the 
destructor. 1 admit this one is tough 
and is a major shortcoming of the 
C++ exception architecture. If you 
don't catch it within the destructor, 
the object's memory will not be freed. 

* There can not be any intervening 
code between a try{> block and its 
catch{) block, although it would 
sometimes be convenient to do so. 

Now let's look at the details of 
Figure 3. In this example, main() calls 
UpdateFooBufsO to allocate some local 
buffers and read some information 
from a file into them, update them, and 
write them back out, UpdateFooBufsO uses 
a tryO block around the code to catch 
any exceptions that might occur while 
allocating the data or reading the file. 
Note the lack of error return codes any¬ 
where in the code. If anything goes 
wrong, the buffers will be freed and the 
exception rethrown so the caller will 
know it failed. 

Note that the pointers were set to 
0 first. In an exception architecture, the 
catch{} block usually does not know 
where or how the exception occurred. 
It can only look at the state of the data 
and act accordingly. Zeroing out the 
pointers first means that we can call 
delete on them without worrying if 
they were ever allocated or not. C++ 
allows delete on a null pointer for this 
very reason. Keep in mind that the 
pointers can not be inside the tryO 
block because they must be visible in 
the catch{} block to be cleaned up. 

This example is meant to be very 
basic and instructive. In reality, I 
would not allocate any raw buffers, I 
would declare a couple of my HEAPBUF 
objects, which would clean themselves 
up as previously discussed, obviating 
the need for a catch{> block in 
UpdateFooBufsO. Figure 4 is a more real¬ 
istic example. In it, you can see how 
automatic object cleanup has simpli¬ 
fied the picture even more. This code is 
as clean as it gets and is very robust 
since there is no elaborate dance to en¬ 
sure that errors get propagated up¬ 
ward through many layers of code. It 
will also have better performance since 
there is only a single try{) instead of 
two nested tries, 

EXCEPTION ARCHITECTURE 

So lets go over a number of extremely 
fundamental architectural differences 
between an exception-driven system 
and a conventional one. 


Exception-driven systems don't 
have error return codes, unlike a con¬ 
ventional system, in which each called 
function or method is followed by a 
(sometimes elaborate) checking of 
error returns. When an error is re¬ 
turned in a conventional system, it is 
usually passed back to the caller, 
which often passes it back to its caller, 
and so on. Basically, a lot of work is 
done manually to achieve the same ef¬ 
fect that exceptions provide for free. It 
is weird at first to look at code that 
never returns error codes, but you will 
come to love it. Be sure to make a dis¬ 
tinction between errors and states—ex¬ 
ceptions are for exceptional occur¬ 
rences, not expected ones. 

Since huge chunks of code can be 
written as though nothing will ever go 
wrong, error handling is all done at 


the end via a catch block or is just left 
to the caller to handle. This freedom to 
think in a straight line is wonderful, 
and the cleanliness of the code makes 
the logic clearer and easier to maintain. 
It also makes that code immune to 
changes in the error reporting strategy 
of the code it calls. 

All code must be prepared at all 
times to have its dynamic resources 
cleaned up in case of an exception. 
Now you see how the automatic 
cleanup of resources in an object-ori¬ 
ented system blends seamlessly into 
the exception architecture. With a little 
care, all the code you write will success¬ 
fully clean up its dynamic resources 
during a regular function exit or when 
an exception unwinds the stack. 

In an exception-driven system, 
any error can be recovered from, and 



Figure 4 An example of a more likely scenario in which objects clean themselves up, so only the 
calling code must install a try{} block , 
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case WJMMD : 

ULONG ulld; 

// Validation functions will throw a string on error 
ulld * Iffl_OLG_MNE; 

ValidateName(uHd); 

did = rTM_DLG_*GE; 

ValidateAge(ulld); 

catch(STRBIG strErr) 

{ 

// Show the message 
ShowHsgChwodDlg, strErr); 

// Put focus back on offending control and return 
VinSetFocus(WinWindowFromld (fiwndOlg, ulld)); 
return 0; 

} 

WinOismis sOlg (hw ndDlg» 1); 


f igure 5. An example of ad hoc exception handling. Not something to overuse, but very 
convenient 


this means that there might not be any 
such thing as a fatal error. Therefore, 
nothing can be left undone, regardless 
of the severity of the error. The "Just 
give up" style is convenient but can 
not be used to create truly robust pro¬ 
grams. When porting an existing sys¬ 
tem, everywhere that the system just 
fell over it will now have to be modi¬ 
fied to clean up after itself—a daunting 
task in a large system. 

THE TROUBLE WITH CONSTRUCTORS 

Exceptions cure a long-running C++ 
problem of constructors that could fail. 
Unfortunately the syntax of a construc¬ 
tor does not allow the indication of a 
failure. So one of two equally distaste¬ 
ful strategies has to be used. One is to 
leave the object partially constructed 
and require an initialization method to 
be called by the client code. This is ob¬ 
viously counter to the raison d'etre of 
constructors, which is to construct ob¬ 
jects. The other is to set a flag member 
and force the client code to check it af¬ 
terward—equally distasteful and error 
prone. Exceptions cure this problem by 
providing a mechanism to report the 
failure of an object under construction. 
(This capability is very important 
when you want to create persistent 
container classes that can not be ex¬ 
pected to understand special case ini¬ 
tialization needs. 


AN ACT OF SELF DESTRUCTION 

Since an exception unwinds the stack, 
it is somewhat of an act of self destruc¬ 
tion. You need to work with three 
basic exception strategies according to 
the circumstances. 

Client Handled. Many exceptions, 
no matter how deeply they occur, are 
intended for handling by the end client 
code. They are allowed to propagate 
up through all general-purpose code 
until they are caught by some applica¬ 
tion-specific code layer that is in a po¬ 
sition to handle it meaningfully. 
Client-handled exceptions are the most 
flexible since the client gets to deal 
with any errors. However, the client is 
then responsible for restarting the op¬ 
eration because the stack has been un¬ 
wound out of the called subsystem, 
losing any context of the call. 

internally handled. Sometimes a 
particular subsystem might wish to re¬ 
main totally fault tolerant regardless of 
the client code. Such systems would 
probably catch most or all exceptions 
that occur within it (or within the gen¬ 
eral-purpose code it calls to do its 
work), recovering and/or restarting 
automatically. The client application 
never knows unless the subsystem in¬ 
forms it in some way. This scheme suf¬ 
fers a little more in performance (par¬ 
ticularly if called repetitively) because 
each entry to the subsystem must in¬ 


stall a try-Q block, which involves sav¬ 
ing the state of the thread on the stack. 

Ad Hoc. For instance, when the 
user presses Ok on a dialog and 1 have 
to validate the input, an ad hoc excep¬ 
tion is a clean way to do so. Figure 5 is 
an example of this type of use. 
Basically I set a variable to the ID of 
the control 1 am about to validate and 
then call a local validation function. If 
the validation fails, the function will 
throw a string object with the explana¬ 
tion of the failure. The catch block will 
display the error, put the focus back on 
the bad control, and then return so the 
dialog is not exited. This code also 
demonstrates the use of flags to give 
the exception handler situational 
awareness {that is, the setting of the 
control ID into a variable the catch 
block can see). 

ERROR OBJECTS 

Finally, you should think about how 
to make your use of exceptions practi¬ 
cal. You cannot require client code to 
have 10 different catch blocks every¬ 
where they do a catch (which would 
be required if you allowed the throw¬ 
ing of a lot of different types.) Instead, 
it is much saner to create an error 
class and only throw objects of that 
class or classes derived from it. The 
basic error class should contain the in¬ 
formation that any error handler 
would need, such as line number, file 
name, error code, and so on. Once a 
basic error class is created, particular 
subsystems can derive from this class 
to create their own specific error 
classes that have extra information. 
Since these new error classes are de¬ 
rived from the base, any code that 
catches the base class (correctly via a 
constant reference) will also catch the 
derived class. 

Error objects must uniquely iden¬ 
tify the source of the error because the 
catching of the object can be far away 
from the source of the throw. So either 
all error codes across all DLLs must be 
unique, not a very good architecture 
for a large system, or the name of the 
DLL must be embedded into the error 
object. I opted for the latter so each 
DLL has the ability to have any error 
codes desired. You can have a new 
error class derivative for every DLL, 
but that does not help the client code 
that chooses to catch all exceptions via 
a reference to the base error object 
class. 
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TROUBLE REACHING NIRVANA 

Exceptions do have some limitations, 
so everything is not milk and honey. 
As mentioned earlier, throwing an ex¬ 
ception in a destructor is a potential 
memory leak. Since any called code 
can potentially throw an exception, 
any destructor that calls code outside 
of its very local neighborhood proba¬ 
bly should put a dummy try/catch 
block around it. 

Another problem is the '"twice the 
cleanup, twice the cleanup" problem. In 
those cases where you do allocate raw 
buffers (such as Figure 3), look at how 
the same exact cleanup must be done in 
two places. The exception handler must 
do it, and the regular exit code must do 
it. Over time, this could become a main¬ 
tenance problem if the cleanup is com¬ 
plex or subtly different in the two 
places. If you don't need access to auto¬ 
matic data, you can create a local func¬ 
tion and call it This would be a very 
good place for C++ to support nested 
functions—a la Pascal/Modula2. 

Exceptions generally put off the 
handling of errors until reaching 
higher-level code. This is a good thing 
since that code understands the cir¬ 
cumstances at hand and can make a 
better determination of how to recover. 
But it also means that those few places 
that handle errors can potentially be re¬ 
sponsible for interpreting a large num¬ 
ber of errors, as opposed to the error 
return scheme where the source of the 
error is obvious and immediate. So the 
burden of recovery is often heavier on 
the client code than in a conventional 
error return architecture. 

SUMMARY 

It is my opinion that in the big picture, 
exceptions just can't be beat, and oth¬ 
ers obviously agree. Taligent, for in¬ 
stance, is a totally exception-driven ar¬ 
chitecture and makes use of all of the 
strategies discussed here and much 
more. Yes, such high-level language 
facilities cost more in terms of CPU cy¬ 
cles than their more primitive breth¬ 
ren, but memory is cheap compared to 
bad press and irate users. The larger 
the system, the greater the payoff in re¬ 
duced code bulk and greater stability. I 
personally can not encourage you 
enough to consider making your next 
C++ project an exception-driven affair. 
You might struggle at first to build a 
formal approach that you feel good 
with since it is a totally different 


world. In the end, however, your 
product will be the better for it. 

Dean Rocfdey is a senior engineer at 
Quantitative Medicine Inc in Annapolis, Md 


QMl is a Marquette Electronics company and 
makes OS/2 based clinical information sys¬ 
tems. Through extensive psychoanalysis, Dean 
has discovered that he actually has a deep 
need to be objectified. 
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1. CSet/2++ supports the ^allocaO function, which will allocate a block of 
data from the stack. Basically it just bumps down the stack pointer. Lf the 
size is known at compile time, this is much faster than allocating from the 
heap, and it is automatically freed on exit from the function. 

2. For a single JANITOR class to work with any type of object, you must have a 
single rooted class hierarchy. If you have a single class FOQOBJ from which all 
classes are derived, you know that any object is a derivative of FQ00BJ, So you 
can use polymorphism to look at any object as a FOODBJ. If the FDDOBJ destruc¬ 
tor is virtual, it will be virtual in all derived classes. So when you delete the 
object via the FGGOBJ pointer, you know that the correct destructor will be 
called no matter what type of object you actually have. Otherwise, you must 
use templates that are beyond the scope of this article. 

3. Slicing can occur because thrown objects are thrown by copying them and 
because the throw keyword has special constraints. So lets assume we have a 
base error class ERROBJ from which we derive a NETERROBJ. In this example, a 
call to a net function throws a NETERROBJ which is caught by the caller. 
FooCatcher catches the object as a constant reference to an ERftOBJ. This is appro¬ 
priate because it allows him to catch any object derived from ERftOBJ, 
However, it then rethrows it explicitly, causing a slice. The reason is that the 
throw keyword uses the compile time type of the object. So the ERftOBJ copy 
constructor is called to make a copy to throw, but that copy constructor will 
only copy those members that belong to the ERROBJ class. The extra members 
added by NETERROBJ will be lost. 

VOID NetFooO 

f 

if (something wrong) 

throw NETERROBJ("This is the error", ERR CODE); 

} 

VOID FooCatcher() 

{ 


NetFooO; 

> 

catch(const ERftDBJi errToCatch) 

{ 

// And rethrow incorrectly!Hl 
throw errToCatch; 

> 

> 
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GUI Development 


This article addresses the challenges faced when creating an easily usable and maintainable 
reservations system fora travel agency. By MARK GAYLER and STEWART MANLEY 


Designing a 
Reservations System 
Graphical User Interface 


Mm nyone who has used the services of 
MM a main street travel agency in the 
past will know that this particular 
industry is not exactly perceived as being on 
the leading edge of user interface design and 
development. Character-based interfaces are 
the norm, occasionally making use of color. 
Many of these systems have not advanced 
beyond glorified 3270 emulations. 

In 1993, we were asked to assist a lead¬ 
ing U.S. tour operator to begin the process of 
moving its reservations systems technology 
firmly into the 1990s by producing a user in¬ 
terface for a cruise line reservation system. 
With significant expertise in the more tradi¬ 
tional host-based online transaction process¬ 
ing (OLTP) and considerable experience in 
MVS-hosted CICS systems on IBM main¬ 
frames, the company required no help in the 
mainframe area. For the new project, how¬ 
ever, the tour operator wanted to leverage 
those skills while taking a bold, forward- 
looking step into the client/server arena. To 
do this, the company wanted to use a token- 
Ting-based network of IBM PS/2 systems 
running OS/2 2.1, LAN Server, and Com¬ 
munications Manager as presentation clients 
to a traditional CICS-hosted transaction 
server. Our brief was to design and imple¬ 
ment a modem, flexible interface that would 
serve as a flagship reservations product for 
the company. 

Such an interface poses challenges in 
two areas. First, it should be designed from a 
usability standpoint to closely fit the work¬ 
ing methods of the ultimate user, the sales 
agent. It's not difficult to create impressive 
interfaces full of the latest design ideas and 
controls, but if this does not actually answer 


the business problem, it is more of a hin¬ 
drance than a help. Second, it poses technical 
challenges to the developer to create a co¬ 
gent, usable, and maintainable support 
structure to permit the interface components 
to be modified, extended, or reused at a later 
date with a minimum of programming ef¬ 
fort. We will address both of these areas in 
this article. 

The interface was designed based on a 
thorough business analysis of the require¬ 
ments of telephone-based reservation sales 
agents, involving staff familiar with the 
process from an early stage. Such agents re¬ 
ceive calls, typically from travel agencies but 
occasionally from the traveling customers 
themselves. Agents have to perform a careful 
balancing act; they must be as courteous, 
helpful, and flexible as possible while keep¬ 
ing the length of the call to the absolute min¬ 
imum required to make the sale. Wasted 
time reduces the number of calls agents can 
process, adversely affecting tour sales and, 
thus, revenue. On the other hand, the cruise 
line for which the interface was being pro¬ 
duced was quite firmly targeting the very 
top end of the marketplace, which created a 
need for the utmost professionalism and 
flexibility during the sales process; cus¬ 
tomers at this end of the market frequently 
"shop" while on the phone to the agent, 
changing suite types, tour packages, itiner¬ 
aries, and so on, before the agent is finally 
able to close the sale. 

Based on these requirements, it was pos¬ 
sible to draw up a set of guidelines to which 
the interface should be designed, including 
the following: 

■ Logical flow. The interface must guide the 
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user through the steps required to 
perform the sales process, from 
accepting basic customer informa¬ 
tion to creating the package and 
closing the sale. It should not allow 
the user to venture into parts of the 
process that are not yet relevant 
since the appropriate data have not 
been collected. 

* Flexibility. While providing a struc¬ 
tured framework for the sales 
process, the necessity to be able to 
handle "shoppers/' who frequently 
change their minds about tour com¬ 
ponents, requires that the interface 
allows the user to be able to quickly 
navigate back and forth to areas of 
interest at will. 

* Nonintrusiveness. Informational 
messages that pop up in the middle 
of the screen and require confirma¬ 
tion by keystroke or mouse click to 
dismiss interrupt the user and 
unnecessarily lengthen calls. All 
informational messages should, 
therefore, be placed on a status bar. 

■ User levels. The travel reservation 
industry makes use of a wide range 
of short code letter combinations to 
represent everything from airport 
and port names to package compo¬ 
nents, suite types, and dietary 
requirements. The interface must be 
able to accommodate the expen* 
enced users, who will wish to type 
in these codes directly, as well as 
less-experienced staff, who may 
wish to select items from a list 


when they do not yet know the 
code. In this way, the novice users 
learn the codes by association as 
they work. 

Based on this analysis, it was ap¬ 
parent that a notebook paradigm 
most conveniently fitted the require¬ 
ments for both a logical flow and nav¬ 
igational flexibility. The notebook, 
oriented with the tabs uppermost in a 
Rolodex fashion, presents the user 
with an instantly recognizable and 
understandable way in which to 
work. Separate notebooks were allo¬ 
cated to each of the main application 
modules; the reservations flow itself, 
along with modules for back office 
staff to maintain agency, inventory, 
pricing, and group allocation details. 

Only one of the notebooks is visi¬ 
ble at any one time, so the frame con* 
trols for the notebook's owner window 
were hidden, making the notebook ap¬ 
pear to be floating in the center of the 
application's main window- (Figure 1), 
reducing screen clutter. Navigation 
between notebooks is achieved using 
the action bar or tool buttons. The 
main window has, in addition to stan¬ 
dard frame controls, a combined sta¬ 
tus bar and toolbar, which displays in¬ 
formation relating to the current caller 
and provides a shortcut to actions in 
the booking process. A message bar is 
also present at the foot of the main 
windows to display the nonintrusive 
messaging. 

The requirement to cater to both 


novice and power users was handled 
by creating a control pair, which be¬ 
came known as a "code/description 
lookup." It consists of an entry field 
and combo box (CBS.DRaPDOWNLIST style) 
pair aligned horizontally with the 
entry field on the left. Examples of 
these can be seen in the upper part of 
the panel in Figure 1. Internally, the 
controls are linked by a simple, sorted 
lookup table structure, which matches 
a code (usually two or three alpha 
characters) to a more descriptive 
string. For example, "LHR" might be 
matched to "London Heathrow 
Airport," If a code is entered into the 
entry field on the left, the lookup is 
performed automatically on each 
change to the entry- field. As soon as a 
match is found, the corresponding de¬ 
scriptive string is highlighted in the 
combo box. Alternatively, a less-expe¬ 
rienced user can select the appropriate 
descriptive string in the combo box, 
and the corresponding code will be in¬ 
serted into the entry field by the 
lookup process. 

GRAPHICAL CABIN SELECTION 

Graphical assistance for the process of 
selecting a cabin was also desirable. 
We adopted an approach using a value 
set to represent the ship's deck, with 
color coding used to indicate the status 
or class of cabin in use (Figure 2). The 
original intention was to use a bitmap 
symbol to denote this, but the process¬ 
ing time required to repaint a large 
value set containing bitmaps was pro¬ 
hibitive. From this panel, the agent 
could display bitmaps of both the 
overall deck layout and the design of 
an individual cabin, scanned from the 
ship's documentation (Figures 3 and 
4). This is of relatively limited use to 
the telephone sales agent, who must 
relay the description to the caller, al¬ 
though it does permit the agent to 
more easily answer questions about 
the relative placement of the suite with 
respect to public areas on the vessel as 
well as the layout of the cabin. The im¬ 
ages will come into their own, how¬ 
ever, as such systems are deployed to 
travel agencies where they can be 
shown directly to the potential trav¬ 
eler. Additionally, they may be ex¬ 
panded in the future to be able to dis¬ 
play digital video clips and sound. 

All visual elements within the ap¬ 
plication were created using Promi- 
nare Designer. Once code had been 



Figure t Reservations notebook interface, 
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generated by the tool custom applica¬ 
tion code was added by hand. Promi- 
nare was chosen not only for its excel¬ 
lent resource editing capabilities, but 
also because its intelligent code gener¬ 
ation engine does not overwrite cus¬ 
tom application code when the inter¬ 
face code is regenerated after 
modifications to the panels* Pro mi na re 
also provides a useful range of custom 
interface controls, such as the recessed 
three-dimensional text field, as well as 
the ability to create further controls. 
The three-dimensional group box 
frame seen in the figures is an example 
of such a control. 

DEVELOPMENT 

The application code fell essentially 
into two main core code engines: the 
support for the notebooks and their 
navigation; and the mechanism con¬ 
trolling the way data was both re¬ 
trieved from host transaction server 
programs and displayed in the panels 
and read from the panels and returned 
to the host. This latter engine became 
known genetically as the parsing en¬ 
gine since its most fundamental task 
was the parsing of data into and out of 
transaction buffers transmitted to and 
from the host server programs. 

NOTEBOOK MANAGEMENT 

Of these two engines, the notebook 
management was the least complex. 
Since speed of navigation through the 
application was a prime business re¬ 
quirement, it was clear that adopting 
the standard approach of creating each 
notebook from scratch each time it was 
surfaced (inserting all its pages and 
initializing any local data) would 
cause an unacceptable performance 
degradation. Therefore, an early deci¬ 
sion was made to preload all note¬ 
books and their pages during applica¬ 
tion startup, also initializing any static 
data such as lookup tables at this time. 
Notebooks could then be surfaced or 
hidden quickly using WinShowVindou* 

The notebook engine was driven 
by two data structures. The NOTEBOOK DAT A 
structure manages all notebook-level 
information, such as owner and note¬ 
book window handles, number of 
pages, and current page number. An 
array of PACED AT A structures maintains 
information about each page in the 
notebook, such as its page number, 
window handle, dialog procedure ad¬ 
dress, and tab and status text. It also 


tracks the ID of the first field on each 
page so the focus can be set appropri¬ 
ately as pages were turned. This page 
instance data was stored with the note¬ 
book page using the BKH.SETPACEDATA 
message* Notebook management func¬ 
tions, responsible for creating and 
populating notebooks and their pages, 
were created. 

Cosmetic features were also im¬ 
plemented. For example, the width of 
major tabs was calculated at run time 
based on the width of the notebook 
and the number of pages it contained. 
This allowed the tabs to neatly fiJl the 
complete notebook width to improve 
visual appearance. Additionally, the 
standard left and right arrow buttons, 
normally used to navigate forward 
and backward in the notebook, were 
deleted and customized buttons added 
to the bottom of each page. The button 
used to move to the next page was 
given default focus so that hitting 
Return moved the agent to the next 
page. 

In addition, each page has associ¬ 
ated with it a status, including values 
such as COMPLETE, INCOMPLETE, and DISABLED* 
This status determines the way in 
which the notebook is navigated by 
the user. For example, during the cre¬ 
ation of a new booking, it is clearly not 
possible to select a suite until such 
time as a cruise has been chosen. Each 
status is associated with a color, which 
is used to draw the text on the page's 
tab* The status flag and a set of page 
management functions manage this 
process. 


DATA PARSING AND DISPLAY 

It became clear early in the design 
process that most of the application's 
operation was involved in accepting 
data entered into panels by the user, 
formatting these data into buffers to be 
transmitted to the transaction server 
programs on the host, and, once a re¬ 
sponse had been received, reversing 
this operation to display the results. 
Transaction data buffers consisted of 
the field values in ASCII text, cate¬ 
nated to form a single text string. 
Clearly, coding this parsing process by 
hand for each individual page was un¬ 
acceptable from several standpoints: it 
would entail vast code duplication, 
greatly increase the complexity of each 
module, increase the likelihood of er¬ 
rors, and create the potential for main¬ 
tenance problems* A common engine, 
therefore, was designed to drive this 
process. 

This engine comprises the bulk of 
the application's core code. A complex 
data structure drives the engine. This 
data structure describes an individual 
field in the transaction buffer, holding 
information such as field name, type, 
format and length, the notebook, page, 
control ID and type with which it is as¬ 
sociated, any field-subclassing options, 
and, finally, a pointer to the field's ac¬ 
tual storage within the application. 
The structures are then aggregated 
Into arrays, each array describing the 
complete set of data associated with a 
single transaction server call, initial¬ 
ized as static data within the appropri¬ 
ate source module. Extensions to the 
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field type and control type allow the 
mechanism to manage simple lists and 
complex repeating data structures 
(OCCURS clauses, for the COBOL-con¬ 
versant), usually mapping these to 
simple or multicolumn list boxes on 
the notebook page (such as the 
Availability list box in Figure 1), 

Two main layers make up the 
complete parsing engine; the panel-re¬ 
lated code and the data buffer hand¬ 
ling. Each layer has two principal 
entry points: ReadPanel and VritePanel 
for the user-interface-related code and 
FormatBuffer and ParseBuffer for the 
transaction buffer management. The 
principal argument to all of these func¬ 


tion calls is the start element of an 
array of data structures as previously 
described. Thus, the developer creat¬ 
ing the code to handle a new panel 
needs to be aware only of these four 
entry points and able to describe the 
transaction in terms of the driving 
data structure, rather than the com¬ 
plete parsing process. Other helper 
functions, also driven by these de¬ 
scriptive data structures, are also 
available to the developer. These in¬ 
clude ConfigurePanel, which manages 
the process of subclassing data fields 
appropriately (for example, to restrict 
input to numeric characters only). 
Verify Pane! for performing data verifi¬ 


cation checks, and ClearPanel for 
quickly deleting the contents of all 
fields in preparation for new work. 
Within the parsing engine itself, indi¬ 
vidual functions for each field type 
and control type are called to manage 
each field in the buffer and control on 
the panel. 

As would be expected for any such 
application, the communications with 
the host transaction server programs is 
managed by a secondary thread with 
an associated object window. Outgoing 
and incoming calls are managed asyn¬ 
chronously, so the call is dispatched 
and control returned to the user inter¬ 
face while the secondary thread waits 
for the response. This response is then 
returned along with a user-defined 
message to the appropriate window. 
This allows status indicator and real¬ 
time clock to be continuously updated 
while the call is in progress. 

VISUAL AIDS 

Wherever possible within the applica¬ 
tion, bitmaps are used on push buttons 
in place of text. Standard images, such 
as the binoculars for the Search button, 
were adopted throughout the reserva¬ 
tion system. This allows the user to 
quickly navigate the system. 

Early in the development cycle, it 
became apparent that users were expe¬ 
riencing difficulty in discerning the 
field that currently had input focus, 
particularly in complex panels with 
many entry fields, due to the small size 
of the caret. This was ameliorated by 
adding handling such that the control 
gaining the input focus changed its 
background color from the default to 
cyan and then restored the default 
color when the focus was lost. 

IMPORTANCE OF PROTOTYPING 

This project provided a perfect illustra¬ 
tion of the importance of accurate pro¬ 
totyping of user interface objects and 
paradigms—or, more accurately, the 
assessment by the developer of the fea¬ 
sibility of such an interface design. 

The interface provided a textual 
equivalent of the suite allocation sys¬ 
tem, the graphical version of which 
used a value set as previously de¬ 
scribed. Use of drag-and-drop had 
been vetoed at an early stage for a 
number of reasons, so the onus was on 
the interface designer to create a 
method of linking a set of passengers 
with one or more suites. 



Figure 3. Deck plan image. 



Figure 4. Suite plan image. 
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The result was a pair of list boxes, 
one of which listed the passengers and 
the other the selected suites, one above 
the other. Between the two was a graph¬ 
ical "link" button. The idea was a sim¬ 
ple one: the agent would highlight the 
set of passengers for a suite, highlight 
the suite, and select the link button. To 
display the linkage between passengers 
and suite, selecting either the suite or 
any one of its occupants would auto¬ 
matically highlight both suite and occu¬ 
pants. Moving a passenger from one 
suite to another could be achieved by 
removing his linkage to one suite and 
creating a linkage to another. 

However, when the time came to 
code this apparently simple and elegant 
interface, we discovered a number of 


problems. How was the code to know if 
the user was selecting for the purposes 
of displaying the link or editing it? In 
other words, the action of the interface 
was inherently modal, so radio buttons 
had to be added at a late stage to enable 
the user to switch between display and 
update actions. Furthermore, the actual 
code required to manage this interface 
became clumsy and difficult to main¬ 
tain, though the interface itself was us¬ 
able. Had the developer taken a careful 
look at the original interface design, 
from the point of view of how it would 
be coded, this situation would have 
been avoided. 

Mark Gayler is a cofounder and technical 
director of Microtransfer Ltd. and has consider¬ 


able experience in the practical application of 
distributed systems in business environments. 
Mark was born in the UX, and was educated at 
the British Columbia Institute of Technofogy. 
Vancouver Canada. Mark can be reached at 
Microtransfer Ltd „ Park Farm Technology 
Centre , Kirtlington, Oxon 0X53JQ, UX. or via e- 
mail at mgayiedWmicro transfer, co. uk. 

Stewart Manley is chief systems architect at 
Microtransfer and is a specialist in the design 
and development of OS/2 cooperative sys¬ 
tems. Stewart has an MSc in Cardiovascular 
Studies from the University of Leeds, which 
comes in handy when SOM programming. 
Stewart can be reached at Microtransfer Ltd., 
Park Farm Technology Centre, Kirtlington, 
Oxon 0X53JQ, UX, or via e-mail at smanley® 
microtransfer.co.uk. 
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Application Migration 


Library vendors will usually provide 32-bit versions of their libraries, but occasionally it is not cost- 
effective to do so. This article discusses how we may still use 16-bit libraries in 32-bit applications. 

By John Calcote 


Thunking: Using 16-Bit 
Libraries in OS/2 2.0 



John Calcote 


^ ecei'idy I have had the opportunity 
to adapt several 16-bit OS/2 li¬ 
braries to a form usable with the 
newer generation of 32-bit compilers for 
OS/2 2.0. Though the ideas presented in this 
article are based on concepts founded by 
IBM's C Set/2 compiler for OS/2 2.0, they 
apply equally well to other 32-bit OS/2 com¬ 
pilers on the market. 


PROTECTED VS. REAL MODE 

Like Intel's real mode, protected mode uses a 
segmented architecture to describe memory 
models available to application programmers. 
Unlike its real mode counterpart, protected 
mode uses segments the way segments were 
designed to be used. While real mode uses 
segments as a sort of Band-Aid to allow the 
application programmer to access 1 megabyte 
of memory with only 16-bit registers, pro¬ 
tected mode uses segments for virtual mem¬ 
ory, for multiple independent application ad¬ 
dress spaces, and to allow the development of 
more powerful system tools using simpler 
memory management techniques. 

When OS/2 2.0 was designed, it was de¬ 
cided that a protected mode flat memory 
model would be used. Since protected mode 
on the 80386 processor supports 32-bit off¬ 
sets, all 4 gigabytes of address space can be 
accessed using only a 32-bit offset—a near32 
pointer. 


MIXED MODEL PROGRAMMING 

To maintain the large investment in 16-bit 
code that had already been established by 
OS/2 application writers, IBM gave OS/2 2.0 
the ability to run 16-bit applications. In so 
doing, it created the possibility that someone 


would want to call 16-bit libraries from a 32- 
bit application. It is even possible (although 
unlikely) that someone would develop a 16- 
bit application that needed to make calls to a 
32-bit library. 

This presents a whole range of problems 
for the operating system developer and the 
application programmer. However, IBM de¬ 
veloped a method in OS/2 2.0 for doing just 
this sort of addressing mode conversion. In 
OS/2 terminology, such a conversion is 
called a thunk. The origin of the word is a lit¬ 
tle vague, but it stems from compiler tech¬ 
nology as a form of parameter passing. The 
connection between this use of the term and 
our use is a bit fuzzy, however. 

In The OS/2 Programmer's Reference, Vol. I 
(commonly called The IBM Red Books), IBM 
outlines an overview of how these thunk lay¬ 
ers should work for the memory manage¬ 
ment scheme incorporated by OS/2 2,0. 
More detail on application programming 
using thunks can be found in volume IV of 
the same reference. (Note that since the re¬ 
lease of OS/2 2.1, IBM has reworked this se¬ 
ries into a slightly less rigorous format and 
has had the series published by QUE Books. 
They can be found in the computer section of 
larger book stores in softcover format.) 

Three main issues should be considered 
when writing 32-bit applications that call 
functions in 16-bit modules: the difference in 
parameter sizes, the 64K boundary problem, 
and the difference in call models. 

Parameter Size . When an application 
written in a high-level language makes calls 
to functions, the most widely used method 
of passing parameters is by a call frame on 
the stack. What this means is that parameters 


48 


OS/2 DEVELOPER 







$8i38E 


A Special Report 
from the 
publishers of 
OS/2 Developer! 


Quantities are limited. 
Order now! 

For fastest service, 
fax your order to us 
at 415-905-4967. 



Jfi YES! Please send me_ copies of Smalltalk! 

Each copy is only $9.95 in the US or $12.95 in Canada. 

Please add $2.50 for shipping and handling. 

□ My check is enclosed 

□ Charge my credit card: Q Visa Q MasterCard □ American 
Express 

Name 

Signature Dale 

Send them to: 

Name 
Address 


Mail: Smalltalk 

P. O. Box 7046 
San Francisco 
CA 94120 

Phone: 1-800-444-4881 
Fax: (415) 905-4967 


City 


j 


Slate 


Postal Code 















■I 


; char dest[100]; 

; char ^source = "John”; 

; strcpy(dest, source); 


PUSH 

OFFSET source 

PUSH 

OFFSET dest 

CULL 

_strcpy 

ADD 

ESP, 8 

PR0C 

^strcpy 

PUSH 

EBP 

NOV 

EBP, ESP 

CLD 


MOV 

ESI, [EBP+8] 

MOV 

EDI, [EBP+4] 

MOV 

EAX, [EBP+8] 

MOV 

ESP, EBP 

POP 

EBP 

RET 


ENDP 

_strcpy 


; 32^bit C source code 


; param 2 
; param 1 
; function call 
; clear pa rams from stack 


; save previous frame pointer 
; make current frame pointer 
; clear direction flag 
; access 'source" as param 2 
; access "dest' as param 1 

; actual code to perform copy 

; return pointer to 'dest' 

; dear any local variables 
; restore previous stack frame 
; return to caller 


Figure 1 , Sample of assembly code that makes a procedure caff to strcpy 


USING BORLAND TOOLS 


In its current implementation, Borland's OS/2 2.0 compiler supports only the 
_Farl6 keyword. Its syntax is a bit different in that it is entirely lowercase, 
_farl6. Furthermore, Borland's version of this keyword should be used to mod¬ 
ify all pointers in return values and in parameters, as well. For instance, while 
a thunked prototype in C Set/2 might look like this: 

char * _FAR16 strcmp(char * ptr); 

the same prototype would be formatted like this in Borland C: 

char _far!6 * _farl6 strcmp(ehar _farl6 * ptr); 

Since the Ipragma seg 16() directive is also missing, it is possible to pass a 
pointer to a data structure that crosses a 64K boundary to a 16-bit function. 
However, it generally requires a fairly large amount of static data to reach this 
point If the program is fairly small, the chances of global data buffers landing 
on a boundary are fairly remote. Still, this is unpredictable and, therefore, 
dangerous. 

Borland suggests not calling 16-bit functions, which require pointers to point¬ 
ers or using pointers to structures containing pointers as parameters, from pro¬ 
grams compiled in version 1.0 of the Borland C++ for OS/2 compiler (Tech 
Bulletin 1632 — CIS forum BCPPD0S/lib2 Til632.ZIP — Using Sybase SOL 
libraries and DLLs in Borland C++ for OS/2). 

This partial support is not entirely critical, as the situation of a structure con¬ 
taining a pointer can often be worked around. 


are pushed onto the stack just before 
the procedure call is made and then di¬ 
rectly addressed on the stack by the 
called procedure. The source code 
shown in Figure 1 shows a sample of 
assembly code that makes a procedure 
call to the standard C library function, 
strcpy. This function takes two 32-bit 
character pointers as parameters and 
returns a 32-bit pointer. This listing 
also shows the beginning and end of 
the procedure itself. 

A calling convention is a standard 
method by which procedure calls are 
made in a high-level language. This in¬ 
cludes passing parameters, creating 
local variables, making the call, and re¬ 
turning return values to the caller. 
Several high-level language calling 
convention standards defined by stan¬ 
dards committees like ANSI are in ex¬ 
istence today. Since this article is 
mainly concerned with OS/2 2.0, we 
will discuss the standard C calling con¬ 
vention, denoted by the keyword, 
_Cded. 

In the C calling convention, para¬ 
meters arc pushed onto the stack from 
left to right, and then the procedure 
call is made. If there is a return value, 
it is passed by the procedure in the 
EAX register. It is the caller's responsi¬ 
bility to clear the parameters from the 
stack after the procedure returns con¬ 
trol to the caller. 

The prolog code you see at the be¬ 
ginning of _strcpy sets up the call frame 
on the stack so parameters and local 
variables may be accessed by a station¬ 
ary frame pointer. Essentially, the call 
frame is a structure on the stack whose 
members are referenced indirectly by 
the base pointer, EBP. EBP is always used 
in this manner, so each procedure must 
assume when it is entered that EBP cur¬ 
rently points to a previous call frame 
belonging to the calling procedure. 

Given this fact, the first thing to be 
done is to save the old call frame 
pointer on the stack by pushing EBP. 
Next, the current stack pointer, ESP, is 
copied into EBP to create the call frame 
base pointer. EBP is used for this pur¬ 
pose in the Intel architecture because it 
implicitly references the segment indi¬ 
cated by the SS register rather than 
that of the DS register. Thus, it is gen¬ 
erally not used for any other purpose 
in a program. 

Since parameters are passed on 
the stack, and the PUSH command will 
only place word-sized objects on the 
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stack, each parameter uses at least the 
number of bytes of stack space defined 
by the machine's basic word size. The 
problem lies in the fact that OS/2 2.0's 
basic word size is 4 bytes, or a dyord, 
OS/2 1,0, on the other hand, uses a 16- 
bit architecture, so its basic word size is 
only 2 bytes. In OS/2 2,0, if the calling 
procedure pushes an unsigned charac¬ 
ter (1 byte) on the stack, a full dyord is 
actually pushed. If a lb-bit function is 
called with such a parameter, it will ex¬ 
pect two bytes on the stack and will ad¬ 
dress the call frame erroneously. 

A thunk must copy the parame¬ 
ters from the 32-bit stack segment to 
the 16-bit stack segment, properly re¬ 
aligning the parameters so they are ad¬ 
dressable by the 16-bit function. 

One more issue to be discussed is 
that of basic integer size. In a 32-bit 
compiler, an int in the C programming 
language is 32 bits, or 4 bytes, wide. 
However, in a 16-bit environment, an 
int is only 16 bits, or 2 bytes, wide. The 
problem is that if an int is passed as a 
parameter from a 32-bit function to a 
16-bit function, the compiler will gen¬ 
erate code to pass 4 bytes based on the 
size of the parameter (not the stack 
size). The 16-bit function will expect to 
find a 2-byte quantity— its definition of 
an int —and will access the stack incor¬ 
rectly. Furthermore, since OS/2 2.0 
sees an int (4-byte object) being 
passed, it will not adjust the size of the 
data object because it is not aware of 
the differences in the sizes of ints on 
the different platforms. 

The fix for this is not to use types 
whose sizes are environment depen¬ 
dent Instead, use short or long, as the 
sizes of these types are not determined 
by basic word size. If the library writer 
used int in the 16-bit library, we must 
rewrite the prototype in the author's 
header file to use a short instead. 

The 64K Boundary , To create an en¬ 
vironment in which both 16- and 32-bit 
code can reside simultaneously, IBM 
redesigned memory management 
under OS/2 2*0. Since the same mem¬ 
ory must be addressable by both types 
of code, some kind of conversion 
scheme from one type of address to 
the other must exist. This scheme 
should be efficient and reliable. It 
should also be algorithmic in nature so 
a high-level language compiler can re¬ 
liably generate a deterministic two- 
way conversion for any address in the 
application's address space. 


In OS/2 2,0, four types of memory 
are available to an application. The 
first type is shared with the system call 
interface. The next is shareable mem¬ 
ory, or memory that may be shared by 
two or more processes. The third is re¬ 
served for 32-bit code and data only. 
The last type lies in an area called the 
compatibility region and may be 


Figure 2 . OS/2 tiled memory scheme. 


shared by both 32-bit and 16-bit code. 

In protected mode, segment regis¬ 
ters no longer point directly to a physi¬ 
cal location in the machine's address 
space. (Note that we will disregard 
paging in this article because its opera¬ 
tion is completely transparent to the 
concepts we are discussing.) Instead, 
segment register values (now called se- 
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lectors) index tables of 8-byte data 
structures called descriptors. These ta¬ 
bles of descriptors are the Global 
Descriptor Table (GDI) and the Local 
Descriptor Table (LOT). Each table 
entry describes a segment—its loca¬ 
tion, size, type, and protection options. 

When a selector register is loaded by 
a program instruction, the CPU uses the 
value stored as an index into the GDT or 
LDT. When the table is accessed, the en¬ 
tire 8-byte descriptor is cached in regis¬ 
ters internal to the CPU for quick access. 



Figure 4 . Data structure crossing a 64K 
boundary. 


Descriptor tables must be con¬ 
tained completely within a 64 K seg¬ 
ment because selector registers are 
only 16 bits wide. This being the case, 
only 8,192 8-byte descriptors will fit 
into a descriptor table. 

This is important because the al¬ 
gorithm used to convert a memory ad¬ 
dress from near32 format to farl6 for¬ 
mat (and back) is based on mapping 
specific memory ranges into each de¬ 
scriptor in the LDT. This algorithm is 
called the Compatibility Region 
Mapping Algorithm (CRMA). The 
CRMA uses a form of memory map¬ 
ping called tiling. What this means can 
more easily be described by the dia¬ 
gram in Figure 2 than by words. 
Essentially, memory is laid out in con¬ 
tiguous 64K regions, each accessible by 
a descriptor in the LDT obtained math¬ 
ematically by a mapping formula. 

In this scheme, selector mapping 
is a simple mathematical process per¬ 
formed with quick shifts, rotates, and 
ORs. By using tiling, the addressing 
schemes of farl6 and near32 are re¬ 
lated by the following C language for¬ 
matted equations. 

near32 = SEL(farl6) » 3 « 16 + 
0FFSET(farl6) 

Shifting right three places and 
then left 16 places has the effect of ze¬ 
roing out the bottom three bits and 


then shifting left 13 places. This is im¬ 
portant because these bottom three bits 
are not technically part of the selector 
index value. Rather, they are the table 
indicator (TI) and requesting privilege 
level (RPL) bits. These three bits make 
no sense in a near pointer. 

farl6 = MAKER(HICH{near32) « 3 + 7 t 
LDU(near32)) 

Shifting the high 16 bits up three 
places moves the table index into the 
selector's index field. Adding 7 to the 
new selector value has the effect of set¬ 
ting the TI bit to 1 (indicating the LDT) 
and setting the RPL to ring three— 
OS/2 application privilege level. The 
effect of these equations are reflected 
graphically in Figure 3. 

OS/2 2.0 currently limits all appli¬ 
cations to the compatibility region to 
assure maximum compatibility be¬ 
tween 32-bit and 16-bit code. There¬ 
fore, all applications that run under 
OS/2 2.0 are limited to 512 megabytes 
of address space, although the theoret¬ 
ical limit is 4 gigabytes. 

Each selector is mapped to a 64K 
segment because the 16-bit offset regis¬ 
ters may access only 64K of memory. 
The 64K boundary problem occurs 
when a pointer to a data structure de¬ 
fined by 32-bit code is passed to a 16- 
bit function. The 32-bit code is not lim¬ 
ited to 64K, and the compiler is 
generally unaware of these 16-bit code 
limitations. The 32-bit compiler could 
possibly lay a data object across a 64K 
boundary, causing a portion of the 
structure to be inaccessible to the 16- 
bit code. Misplacement of such a data 
structure is shown in Figure 4. 

To solve this problem and others 
related to pointers, IBM added the 
compiler directives, #pragma segl6() and 
#pragma stackl6(), and a couple of new 
keywords, .Farl6 and _Segl6, to the C 
Set/2 compiler. 

The Ipragma segl6() directive tells 
the compiler to align the enclosed data 
object on a 64K boundary. If the object 
is less than 64K in size, it guarantees 
its placement entirely within a 64K 
segment. The code excerpt in Figure 5 
shows how Ipragma segl6() works. 
Notice that the directive works 
through typedefs as well as directly. 

In this example, the keyword, _Farl6, 
is used in the function prototypes to tell 
the compiler that calls to these functions 
should be thunked to 16-bit calls. 


Ipragma stack16(8192) 

//8192 stack for farie calls 

char buffer'512 ; 

Ipragma $egl6{buffer) 

//buffer is 64K aligned 

typedef struct myStruct { 
char * _Segi6 name; 
short flags; 
short time; 

> RYSTRUCT; 

fpragma segl6(MYSTRUCT) 

mystruct ms; 

NYSTRUCT * _$eg!6 pms = ms; 

// all variables of type 

U MYSTRUCT are 64K aligned 

H ms is 64K aligned 

H pus stored in far16 format 

void _Farl6 .Pascal Function*(HYSTRUCT +); 
void _Farl6 .Pascal FunctionB(MYSTRUCT **}; 

void main() { 

F unction A{ Ants); 
FuncticnBUpms); 

> 



Figure 5 , Example of how ipragma $egl6() works. 
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The function of _Segl6 is to force 
storage of a pointer in farl6 format. 
This is necessary because the compiler 
can not be relied upon to know that 
this field of the structure will be ac¬ 
cessed by the 16-bit function when it 
receives a pointer to an instance of this 
structure as a parameter. 

For instance. Function* () in Figure 
5 will automatically convert the 
pointer to HY5TRUCT to a far 16 pointer by 
virtue of the use of .Far16 in the proto¬ 
type. However, it has no way of know¬ 
ing that the character pointer stored 
within the structure will be accessed 
by Function* (}. It should be stored in a 
manner compatible with 16-bit code, 
using the _Segl6 keyword. 

Pointers to pointers should also be 
considered carefully. The compiler will 
generate the conversion for the pointer 
passed, but its value is also a pointer 
and should be stored in farl6 format 
for the receiving code's benefit. In the 
example of Figure 5, this concept is de¬ 
picted in the parameters of the call to 
FunctionBC). 

Finally, since a different stack is 
used in 16- bit function calls, the direc¬ 
tive (pragma stackl6() allows the applica¬ 
tion designer to specify the size of the 
16-bit stack segment. (See the sidebar 
"Using Borland Tools" for an explana¬ 
tion of the thunk support differences 
between Borland tools and IBM tools.) 

The Difference in Call Models. The 
third issue that must be resolved by a 
thunk is that of call model differences. 
The 32-bit code is making near32 calls, 
while the 16-bit code is expecting to re- 
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Figure 6. Near32 call and far ! 6 call. 



extern void foo(void); 


void mainO { 


foo(); 


> 


.386 


.model FLAT 


assume cs: FLAT, ds: FLAT, ss: FLAT, es: FLAT 

_TEXT segment dword public use32 

'CODE' 

jnain proc near 


ENTER 0,0 ; 

set up stack frame for main 

CALL near ptr _foo ; 

call foo (underscore added) 

POP EBP ; 

restore stack frame 

RET ; 

return from main 

.main endp 


.TEAT ends 


extrn ^foo:near ; 

declare foo as extern 

public .main ; 

declare main as public 

end 



Figure 7. Code before minor changes. 


extern void _Farl6 

_PascaX foo(void); 

void mainO { 
foo(); 

> 

.386 

.model FLAT 

assume es: 

FLAT, ds: FLAT, ss: FLAT, es: FLAT 

.TEXT segment dword public use32 'CODE* ; NOTE: 32-bit seg 

.main proc near 

ENTER 

0,0 ; 

; setup stack frame for main 

CALL 

near ptr foo$32 

; call thunk layer for foo 

POP 

EBP ; 

; restore stack frame 

RET 

j 

; return from main 

.main endp 

foo$32 proc far 


thunk layer for foo 

ENTER 

4,0 

stack framej 4 bytes local 

PUSH 

EBX 

OS/2 1.0 does not preserve 

PUSH 

EM 

these three registers 

PUSH 

ESI 

in its 16-bit functions 

PUSH 

ES 


NOV 

dvord ptr [EBP-4],ESP 

NOV 

AA ,SS 

; Setup 16-bit stack 

CAP 

lit,seg FUT:.0*TA 

JE 

short ND.B0UNDHRY 

NOV 

E A A, ESP 


CHP 

AA,4096 


JAE 

short NO.BOUNDIRY 

XOR 

AX, AA 


ACHG 

ESP,EAX 



Figure It Code after minor changes (continued on page 541 
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turn from farl6 calls* After a 32-bit 
near call, the stack is described by the 
diagram of Figure 6a. After a 16-bit far 
call the stack would look like the dia¬ 
gram of Figure 6b, 

To solve this problem, the thunk is 
comprised of two separate segments, a 
32-bit segment and a 16-bit segment. 
The 32-bit portion performs a far jump 
to the 16-bit segment, which calls the 
16-bit function. When the 16-bit func¬ 
tion returns, the 16-bit portion of the 
thunk performs a far jump back to the 
32-bit segment, which then returns to 
the caller* 


A NETWARE EXAMPLE 

1 first came upon the need to deal with 
mixed model code about 16 months 
ago while beta testing Borland C++ for 
OS/2. Since i work for Novell, the ob¬ 
vious test for the compiler would be to 
try to create some NetWare-aware ap¬ 
plications using the NetWare C 
Interface for OS/2. Unfortunately, the 
NetWare C libraries had not yet 
caught up to the 32-bit version of 
IBM's PC operating system* From 
Novell's and its customers' stand¬ 
points, it did not make much differ¬ 
ence because the NetWare requester 
for OS/2 2.0 was still entirely 16-bit 
code* All of the earlier 16-bit utilities 
would still work under OS/2 2*0* 
Finally, most of the OS/2 engineering 
team at Novell still used Microsoft C 
6.0 for OS/2 1*0 to develop Novell's 
OS/2 NetWare utilities. 

Since the NetWare requester, li¬ 
braries, and DLLs were all 16-bit code, 
a conversion layer needed to exist at 
some point along the chain of commu¬ 
nication between the 32-bit application 
I was attempting to build and the 16- 
bit requester. 

Novell did a splendid job of ab¬ 
stracting all of the NetWare C Interface 
data types, defining most of those 
types in a single header file. To create a 
model-independent library, all mem¬ 
ory locations are passed as 32-bit far 
(far!6) pointers and all function calls 
are made as far calls. 

This model-independent library 
concept turned out to be an excellent 
advantage to my conversion work be¬ 
cause most of the work had been done 
for me. I simply redefined the abstract 
keyword, NHFAR, from far to .Far 16* Then 
I changed all references to type int in 
the header files to short since, as dis¬ 
cussed earlier, the 16-bit code expects 


16-bit integer quantities passed on the 
stack for 'int' parameters. 

After three or four changes to a 
single header file, 1 was making 16-bit 
library calls from a 32-bit application* 
The use of a few we 11- placed lidef di¬ 
rectives made the library compiler and 
OS version independent. 

Prototypes for functions in a 16-bit 
OS/2 1.x library typically look some¬ 
thing like this: 

int far FunctionH(char ♦a, int b); 


The same prototypes adapted for a 32- 
bit OS/2 2.0 compiler look like this: 

int _Farl6 .Pascal FunctionA(char *a, 
short b )\ 

void _Farl6 .Pascal functionB(void); 

char * _Fari6 .Pascal FunctionC(char 

Note the use of the .Pascal key¬ 
word. OS/2 1*0 makes use of Pascal 
calling convention by default, whereas 
2.0 defaults to C calling convention. 


void far FunctionB(void); 

char far # far FunctionC(char *a); 

The next example demonstrates 
what happens when the compiler finds 

NO.BOUNDARY; 

PUSH 

EBP 


NOV 

EBI.ESP 


PUSH 

SS 

; save 32-bit stack 

PUSH 

EBX 


LEA 

ESI.dwrd ptr [EBP+8] 

m 

EUjECI 


SUB 

ESP,ECX 


NOV 

EOT,ESP 


REP MOVSB 


move parameters 

MOV 

EAX,ESP 

perform address thunk 

ROR 

Ell,16 

put seg in M 

SHL 

AX,3; 

move descr Inde* 

OR 

Al,7 

set T1 and RPL bits 

RDL 

Ell,16 

restore seg to E(AI) 

PUSH 

EM 

push Seg and Offset 

LSS 

SP,dword ptr [ESP] 

switch to 16-bit stack 

JMP 

far ptr foo$16 

JUMP to 16-bit thunk 

RET.FOO: 

J 

; return point 

SHL 

EM, 16 

; restore 32-bit stack 

SHRD 

EM,EDI ,16 


mm 

ESP,SP 


LSS 

ESP,fword ptr [ESP] 


POP 

EBP 


MOV 

ESP.dnord ptr [EBP-4] 

POP 

ES 


POP 

ESI 


POP 

EDI 


POP 

ESI 


LEAVE 

j 

; dean up locals 

RET 

3 

; return to caller 

foot32 endp 

JEXT ends 

e*trn FQQ:near 


public .main 


assume cs:_ 

TEHT16 


VTEIT16 segment word public usel6 'CODE' ; NOTE: 16-bit seg 

foo$16 proc far 


16-bit thunk layer 

CALL 

far ptr FQO 

call 16-bit function 

JMP 

far ptr RET.FOO 

return to 32-bit thunk 

foo$16 endp 
_TEXT16 ends 
end 


Figure 8 . Code after minor changes (continued from page 531 
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an instance of the .Far 16 keyword in a 
function prototype. The code fragment 
shown at the top of Figure 7 generates 
the assembly output below this frag¬ 
ment in the same listing. This code is 
straightforward. 

Now look at the same fragment 
with one minor change at the top of 
Figure 8 and then the generated as¬ 
sembly output below it. 

With this information, it should be 
a fairly simple process to convert most 
16-bit OS/2 libraries or DLLs to a form 
usable by a 32-bit OS/2 compiler by 
tweaking the header files for the li¬ 
brary a bit. After all, what good is a 32- 
bit application without access to the 
outside world through existing li¬ 
braries? One would think this would 
not be much of a problem really, but I 
was amazed at the stumbling blocks I 
came across when trying to use li¬ 
braries that were common to the OS/2 
1.0 programmer. The information in 
this article should make the learning 
curve a little easier to handle for you 
than it was for me. 


John Calcote is currently a course devel¬ 
oper and instructor for advanced computer 
science topics at Novell's Services Division. 
He has been a senior consultant and pro¬ 
grammer for Cincinnati Bell Information 


Systems and an advanced support techni¬ 
cian for Novell. He has a bachelor's degree 
in computer science from Brigham Young 
University. He can be reached via internet 
at jcalcote@novell.com. 
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This article offers some translation principles to consider when designing, coding, and testing a product 
for international use. By BENETTA PERRY 


Translated Products: 
Designing and Testing 


MK any people and activities are in- 
MmjM volved in getting a software 
M m m product translated and tested* 
Translation entails much more than just find¬ 
ing someone to convert the English text into 
another language. Translation for Program 
Integrated Information (PII) 1 and publications 
costs in IBM can be several cents per word or 
more, depending on what must be translated, 
schedules, and the availability of translators. 
Plus, additional costs are often incurred be¬ 
cause many developers do not design and 
code their original application for translation, 
that is, for future international use. 

The testing of a translated product is 
also dependent on its design. If the product 
is properly designed, the testing effort is 
simplified, thus lowering the cost of getting 
the translated product to market. 

In this article, we'll offer some transla¬ 
tion principles to consider when designing, 
coding, and testing a product for interna¬ 
tional use. 


DESIGNING A PRODUCT FOR 
INTERNATIONAL USE 

Internationalization is the design and coding 
of a software product for international use. 
First, you should separate all code from any 
text that is displayed to the user. None of 
this text should be hard-coded or embedded 
within a piece of code. Translating text 
should not "break" the product. Avoid the 
use of restricted field lengths. When trans¬ 
lated from English to other languages, text 
often expands in length and requires more 
on-screen space. 

If these and other rules are not followed 
in the design stage, there will be changes to 


the product during the testing phase. The 
costs of application changes during the test¬ 
ing phase are nearly double the cost of im¬ 
plementing the same changes earlier, 
"Translation Procedures," an IBM 
Information Development Guideline, ad¬ 
vises authors how to write for efficient trans¬ 
lation. It discusses terminology, writing 
style, physical factors (page layout, tags, 
white space, graphics), cultural factors, spe¬ 
cial concerns with online information, and 
other items of concern. 

Developers can design a product for in¬ 
ternational use by applying the following 
quality translation principles during design 
and coding: 

* Make sure artwork (faces, animals, 
phones, and so on) is culturally neutral. 

* Avoid examples that are specific to the 
U.S, culture or way of doing business 
(banking, payroll, sports). 

* Avoid illustrating idiomatic expressions 
specific to the U.S. English language In the 
text or artwork. 

* Do not use humor. 

* Use irony with caution, 

■ Avoid slang, jargon, and colloquialisms. 

* Do not use personifications, 

* Do not express dates in all-number formats 

* Use consistent wording; using "also 
called" and "synonymous w T ith" is incon¬ 
sistent. Ask coworkers to review the text 
looking for inconsistent terminology, 

* Use clear and precise wording; avoid 
ambiguous words. 

* Avoid grammatical errors. Use a spell 
checker or proofing tool to eliminate all 
spacing errors, misspelled words, and 
double words. 


MAY/JUNE 1 $ B 5 





Use complete sentences. 

Reduce unnecessary words; com¬ 
bine similar help panels where pos¬ 
sible and appropriate. 

Avoid editing the English after 
translation has begun. 

Use correct references; cross-check 
your work. If you refer the user to a 
section, make sure the section title 
and section reference are identical. 
Minimize the use of hard-coding 
references; use tags if possible and 
tools if available. 


If the previous guidelines are not 
followed, your application product 
may: 

• Cause translators to initially trans¬ 
late the PII improperly, requiring 
them to retranslate later, doubling 
the cost 

• Cause schedule delays because trans¬ 
lators become confused and ask many 
questions, decreasing productivity 

• Cause translators to translate unnec¬ 
essary words, thus raising the cost 
of translation 


L 

YES NO N/A 

All PII and presentation control information is 
isolated from executable code at the source and at 
the load module level. 

2. 

YES NO N/A 

Provision is made for displaying longer messages 
due to expansion during translation. 

3. 

YES NO N/A 

Functions dependent on location of panel 
elements are not inhibited by display position 
changes caused by PH expansion. 

4. 

YES NO N/A 

Development provides translators with a method 
for tracking messages and panels. 

5. 

YES NO N/A 

Variables used in PII are permitted to assume any 
location and order within a display field. 

6. 

YES NO N/A 

Icons and clip art are treated as PII. 

7. 

YES NO N/A 

Inputs such as commands, keywords, and 
responses are treated as PII. 

8. 

YES NO N/A 

Calendar formats are selectable. 

9. 

YES NO N/A 

Date formats are selectable. 

10. 

YES NO N/A 

Formats for time of day are selectable. 

11. 

YES NO N/A 

Cardinal number shapes (Hindi, Arabic, Thai, and 
so on) are selectable. 

12. 

YES NO N/A 

Mathematical/Numeric formats are selectable. 

13. 

YES NO N/A 

Format of monetary values is selectable. 

14. 

YES NO N/A 

System for measurement of physical quantities is 
selectable. 

15. 

YES NO N/A 

Sentence spacing and punctuation is selectable. 

16. 

YES NO N/A 

Design of such functions as sorting, searching, 
merging, comparing, and rounding allows for 
uniqae country and language requirements to be 
satisfied. 

17. 

YES NO N/A 

Each keyboard layer is capable of having a caps 
lock function and a shift lock function that are 
independently operable. 

18. 

YES NO N/A 

Positioning of graphics on the tops and front faces 
of keys must not be restricted by the 
manufacturing process. 


Figure 1. Checklist for designing a translatable product. 


• Cause these problems to be discov¬ 
ered late in the product cycle, forc¬ 
ing translators to make corrections, 
possibly introducing still other 
problems into the product. 

• Cause automated translation tools 
to be ineffective. 

Figure 1 shows a general checklist 
to use when designing a product for 
international use. 

TRANSLA TION PRINCIPLE CASE STUDY 

Does applying these translation princi¬ 
ples affect translation costs? In one 
study in which a product was trans¬ 
lated into 15 languages, just reducing 
the number of words saved money. In 
eight help panels, unnecessary words 
were eliminated, cutting the word 
count from 476 to 288. Assuming 
translation costs of 50c per word, the 
cost savings from cutting unnecessary 
words totaled $1,400. Imagine possible 
cost reductions if the other quality 
translation principles had been applied 
throughout the coding of the product. 

Our analysis shows that translation 
costs increase when quality translation 
principles are applied during testing. 
Translation costs are likely to be lower 
when developers apply the translation 
principles as they code the product. 

TESTING TRANSLATED PRODUCTS 
Testing Europe/Middle East/Africa (EMEA) 
Translated Products on OS/2. Depending 
on how the application was designed, 
the developer of an OS/2 application 
could do some functional testing 
using the English language version of 
the application. 

First, reconfigure OS/2 for the 
specific country desired. This is accom¬ 
plished by simply changing the COUN¬ 
TRY®, DEVINFO=KBD, and CODEPAGE® state¬ 
ments in the config.sys as shown in 
Figure 2. The parameters for these 
statements are listed in Table 1. 

Second, reboot your system. Load 
the application. Any culturally sensi¬ 
tive functions should be displayed in 
the proper country format. 

If an application uses Prf* APIs for 
OS/2 Presentation Manager, the oper- 


country*001,C:\0S2\SYSTEM\C0UNTRY.SYS 
codepage=850,437 

devinfo®KBD,US,C:\0S2\KEYBOARD.DCP 


Figure 2. Statements in config.sys. 
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a ting system can be configured for cul¬ 
tural settings in another method other 
than changing the parameters in the 
config.sjs file. 

This is done from the OS/2 
Presentation Manager by changing the 
parameters of the Country Settings 
panel behind the System Setup panel 
Such modification changes the corre¬ 
sponding entry in the os2.ini file. 

The changes take effect when the 
OS/2 Presentation Manager GUI ap¬ 
plication is run. 

The keyboard layout can be 
changed from the OS/2 command line 
by using the KEYB command followed 
by the keyboard ID (for example, KEYB 
FR for France), 

The current code page can be 
changed from the OS/2 command Line 
using the CHCP command (CHCP 850 
changes the current code page to 850, 
but CHCP used alone simply displays the 
current code page). 

Testing Asia/Pacific (AP) Translated 
Products on OS/2. For Asia/Pacific coun¬ 
tries, their respective operating sys¬ 
tems, as listed in Table 2, have to be in- 
stalled and then the application loaded 
to test for culturally sensitive functions. 
(IBM developers: contact your NLS Site 
Coordinator for procedures on obtain¬ 
ing these operating systems, Non-IBM 
developers need to go through normal 
IBM marketing channels to purchase 
these operating system versions.) 

What To Look For In The Translated 
Product The developer should execute 
all of the products' functions that he or 


she has designed and coded. However, 
the designer does not need to config¬ 
ure the system for all languages. The 
testing department is responsible for 
thoroughly covering all languages and 
all functions. The following are some 
specifics to look for: 

* The time format is correct for the 
specific country. Examples are 
shown in Table 3. 

* The date format is correct for the 
specific country. Examples are 
showm in Table 4, 

* The numerical format is correct for 
the specific country. 

* The sorting is correct for the specific 
country. 

* The appearance of the translation is 
appealing to the eye, 

* The major functions of the product 
still work. 

The formats presented in Table 3 
and Table 4 are not specific to only 
OS/2 but are the national language in¬ 
dustry standards. OS/2 may or may 
not have adopted each given format. 

The initial design and coding of 
an application for future international¬ 
ization greatly simplifies the language 
translation and testing activity later 
on. Errors or design flaws in the origi¬ 
nal English version can greatly impact 
translation and testing costs as each 
new country version is modified and 
tested. National language translation is 
a big help in making applications 
ready for internationalization. For 
companies to remain competitive and 
profitable in foreign markets, however. 


it is important that developers follow 
these design and coding guidelines. 

Benetta N. Perry is a senior associate pro¬ 
grammer at IBM Austin , Tex. In her 11 years 
with IBM[ she has specialized in software qual¬ 
ity assurance, testing products for functional 
accuracy, performance r memory , and disk 
usage. She has worked on OS/2\ 0 Sd2 
Communications Manager f OS/2 Database 
Manager , OS/2 Query Manager , and the 
Distributed Computing Environment for VS/2 , 
Currently she is a member of the National 
Language Translation & Support team working 
to translate and test LAN products, Benetta has 
a B.S. degree in computer science from 
Grambling State University. 


OS/2 ] ... Japan 
OS/2 H ... Korea 
OS/2 T... Taiwan 


OS/2 P... People's 

Rep. China 

Table 2. AP operating systems. 

COUNTRY 

TIME FORMAT 

Sweden 

h.mm.ss 

Germany 

h.mm.ss 

Italy 

h.mm.ss 

Denmark 

h.mm.ss 

France 

h:mm:ss 

Norway 

h:mm:ss 

Spain 

h:mm:ss 

Japan 

h:mm:ss 

Korea 

h:mm:ss 

People's Rep, China h:mm:ss 

Taiwan 

h:mm:ss 

Thailand 

h;mm:ss 

Table 3. National time format. 

COUNTRY 

DATEFORMAT 

France 

dd/mm/yyyy 

Germany 

dd.mm.yyyy 

Italy 

dd/mm/yy 

Spain 

dd/mm/yy 

Norw'ay 

dd.mm.yy 

Japan 

yyyy-mm-dd 

Sweden 

yyyy-mm-dd 

Denmark 

dd-mm-yy 

Korea 

yyvy*mm.dd 

People's Rep. 


China 

yyyy.mm.dd 

Taiwan(Big 5) 

yy/mm/dd 


Table 4, National date formats. 



OS/2 

OS/2 

OS/2 

OS/2 


COUNTRY 

KEYBOARD PRIMARY 

SECONDARY 

Gkbd 

COUNTRY 

CODE 

ID 

CP 

CP 

LAYOUT 

Canada(French) 

002 

CF 

863 

850 

058 

Denmark 

045 

DK 

850 

— 

159 

France 

033 

FR120 

850 

437 

120 

Germany 

049 

GR 

850 

437 

129 

Italy 

039 

IT142 

850 

437 

142 

japan 

081 

JP 

942 

437 

103 

Korea 

082 

KR 

949(KS) 

850,437 

103 

Netherlands 

031 

NL 

850 

437 

143 

Norway 

047 

NO 

850 

—■ 

155 

People's Rep, China 

086 

PR 

1381 

437,850 

41AB 

Spain 

034 

SP 

850 

437 

172 

Sweden 

046 

5V 

850 

437 

153 

U,S, 

001 

US 

437 

850 

101G 

Rep. of China 

0 88 

TW 

950(Big 5) 

437,850 

103 


Table t. eon fig. sys parameters 
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money, and spend it a little more wisely 


So stamp out ignorance, and write today for the latest free Catalog. Send your name and 
address to: 

Consumer Information Center 
Department SB 
Pueblo, Colorado 81009 

U.S. General Services Administration 


A public service of this publication and the Conumer Information Center of the U.S. General Services Administration. 
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A PROGRAMMING TOOL 
THAT WON'T SCREW YOUR HEAD UP 


Splat! There goes another masterpiece* ft was 
going to be a work of art, a monument to elegance and 
flexibility* It was going to be your finest creation. What 
happened? It got beaten into unrecognisable garbage 
by some clumsy GUI builder. As for the controls, they 
ended up as subtle as a flying sledgehammer thanks to 
a resource editor with an attitude. 

This kind of mental torment could turn a decent living 
programmer into a serial killer. Somebody out there had 
better come up with a solution. 

We just did* It's called Prominare, a professional's 
programming tool for GUI creation that has all the answers. 

Take a look at the code it generates and you'll find it 
looks very familiar. It's exactly the way you would have 
written it yourself* If that sounds a bit scary, don't worry, it's 
real friendly. Define your naming convention and Prominare 
will stick to it to the letter* Prominare generates code exactly 
the way you want it* Your way* 

If your looking to create custom 
controls. Prominare is a designers dream. 

Use it as the resource editor and you'll find 
that you have enough options to give you 
total freedom. If will also handle all major 




Prominare 

■MKi Lite 


AVAILABLE ON THE INTERNET 



object libraries and happily deal 
with PEN and multimedia. It 
handles all versions of OS/2 and 
there's no problem with understanding 
your old resources or Windows resources either. 
Apart from being friendly, Prominare is also 
intelligent. When you make modifications to an application 
you won't be hindered by unnecessary generation phases, 
because it only regenerates the parts that have been 
modified* If you wish to make a manual modification 
Prominare will honour and obey it. 

Now here's the best bit. We've produced a shareware 
version called Prominare Lite that's freely available on the 
Internet* Just help yourself to it and see how it beats the 
stink out of anything else. Then get your head around this 
question. If the shareware version is this good, what will the 
full version do? 

Prominare 

Tel: +t (416) 363 2292 Fa* +1 (4t§> 363 6157 
Tsl *44 f 117) 972 8500 Fax +44 (11 7) m 8600 
e-mail dtttyitr9inttrlQ0.com 

anonymous ftp: oold.mter1ofl.com7pub/|jrom(rare 
AVAILABLE THROUGH 

INDELIBLE BLUE T£l: 1-800-776 6284 (OUTSIDE USA 1 -91 9-178-9700) 

OS/2 EXPRESS TEL: 1-80C-673-SW$ (OUTSIDE USA V 612 *236256) 
EGGHEAD SOfTY/ARE TEL 1 -800-344-1 \2$ (OUTSIDE USA 1-509 922 7031) 
IMAGESOFT INC TEL: t-800-245-8840 (OUTSJDE USA 1-516-767-2233) 
PROGRAMMERS PARADISE TEL 1-800-441-1511 (OUTSIDE USA 1-0O8-369-922B) 
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TCP/IP for OS/2* 
Our customers say our t 


is the best because 
it’s faster, more complete, 
and reliable. 

Find out for yourself! 


Supported: all released versions of OS/2 
including 32bit API for 2.x and above; 
SUP and/or PPP on COM1 and/or COM2; 
Ethernet; Token Ring; ARCNet; NDIS and ODI 


Essex Systems, Inc. 

One Central Street, Middleton, MA 01949 
A Dan Lanciani Product 

TCP/2 is a Trademark of DLD consulting. All other products and trademarks arc the property of 
their owners, TCP/2 is Based in part on work done by the University of California Berkeley. 


Send text messages to pagers 
directly from OS/2! 

Easy-to-use workplace shell application 
Includes a command line interface 
You can 'page-enable ' your applications! | 
32-bit, SOM-based code - Only $79. 

ChipChat® Wireless Communicator 

ChipChal-Cawthon Software 
Dearborn , Michigan USA & Fukuoka Japan 

Phone 313-565-4000 Fax 313-565-4001 
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JOB SCHEDULING SERVER 

OS/2 PM 32-bit advanced job scheduler for NOVELL 
and IBM LANs. Schedules multiple OS/2, DOS, and 
Windows jobs for concurrent execution on specified or 
auto selected LAN nodes. Conditional job scheduling 
(depends on files and other jobs return codes), security, 
sophisticated calendar, job logging, priority, user APIs, 
job recovery, periodic scheduling, and much more. 

Micro work, Inc. 

Pkone: (708) 940-8979 Fax: (70S) 940-8979 
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Opt-Tech Sort/Merge 

High Performance Sort/Merge/Select Utility 

Use as a stand-alone utility or call as a Subroutine. Many 
features including unlimited file size, multiple keys, record 
selection, duplicate elimination, summing and more! 

Call for free brochure Opt-TechData Processing 
P.O. Box 678 
Zephyr Cove, NV 89448 
Phone (702) 588-3737 
Fax (702) 588-7576 


Available for: 

OS/2 or Unix $249 
DOS or Windows SI 49 
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OS/2 »»■»» 

Essentials 


File Manager 
Task Bar 


Screen Saver 
Directory Space Grapher 

A must have for any serious developer! 

Stardock Systems Inc, 


Gu entity Discounts 
Site Licensing Avertible 


mew: (313J/7S2 22J@ foe (3131/762-9666 
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The easy to use 32 bit OS/2 PM IFF Language Editor 


IPF Editor: $150 

Voice Support Moduli: $50 


IPF Editor 

Add help to applications in minutes 
Designed for easy use by programmers and non-programmers 
Generate C and Resource source files to 
add help to applications automatically 
I- Import wordprocessing files, including 
WordPerfect, quickly and accurately 
Preview IPF output without compiling 
|* Create all hypertext links automatically 
Optional Voice Support Module 
|* Includes complete on-line help and 
documentation 


Orders: 

1-800-IPF-7622 

Information: (360)428-5025 
oft CompuServe at 

79419*2416 


Perez Computing Servic&s 
4725 Monte Vista Place 
Mt Vernon, WA 98273 


Products & Services Guide ads 

help you reach 36,000+ 
professional OS/2 Developers 
cost-effectively... 

1/8 page ads are 
as little as $364/inserticn 

Call today for details: 

Kristin Morgan /212-626-2498 
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Build anti Browse IDL with ORBitize™ 

ORBitize™ eases the development of distributed objects 
using an object request broker (ORB). It provides an intuitive 
graphical user interface tor creating and browsing OMG IDL 
definitions rapidly. ORBitize™ browsing capabilities let you 
easify view and understand IDL definition hierarchies and 
quickly navigate between definitions. ORBitize™ eliminates 
the need to learn IDL syntax, allowing new developers to 
quickly produce error-free IDL. 

ORB$: $0M r QbjectBroker, Orbix, TME, and others 
Platforms: OS/2\ Windows, NT, UNIX 
74 Northeastern Blvd., Ste. 8B, 

Nashua, NH 03062 
v: 603-504-0525 f: 603-594 
email: lnfoQnetllnks.com 
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Data Acquisition for OS/2 

Presenting IOPRQ/VX, This toolkit allows you to unleash the 32 
bit multitasking power of OS/2 and the incredibly easy to use 
development environment of VX-REXX against any and all of 
your data acquisition or process monitoring and control applica¬ 
tions! Plug in your favorite I/O adapter, drag and drop to build 
your app, and that’s it. Or, create your own screen instrument 
panels and remotely control your instrument via RS-232, IEEE- 
488, or a network! 

Rock Solid Software 

Call or write for a free brochure. 5460 Plank Road Box 228 

Montville, OH 44064 


If it 's done right, chances arc it ’s Rock Solid 


(216) 390-0590 


OS/2 te t rrjyvi'ft'd inuknurit nif Inwmatifiml Efcnimu Machines Cnrp®™*®n 
VX-REXX IH J Ifajcnurh , jf WiKixn tmtmatk-jiul Crap. 
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FAX Developer Tools 

From the developers of FaxWorks for OS/2 

Client/Server API and Printer Driver Toolkits 
Support for LANs, up to 96 lines per CPU, 
and all popular fax hardware 

Keller Group Inc. 

Voice: (612) 429-7273 Fax: (800) 329-3293 

Email: kgroup@ibm.net Fax: (612) 653-1987 

FaKworks is a trademark of Global Village Communication 



It's easy 
to integrate 
business graphics 
into your 
OS/2 P\f 
or 

Windows 3.x* 
application 


Developer’s Business Graphics Toolkit 











































































ADVERTISER INDEX 


Invest 
a stamp 



Save 
a bundle 


For the price of a stamp, you can get the latest edi¬ 
tion of the federal government's free Consumer 
Information Catalog listing more than 200 free or 
low-cost government publications on topics such as 
federal benefits, jobs, health, housing, education, 
cars, and much more. Our booklets will help you 
save money, make money, and spend it a little more 
wisely. 

So stamp out ignorance, and write today for the lat¬ 
est free Catalog. Send your name and address to: 

Consumer Information Center 
Department SB 
Pueblo, Colorado 81009 
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OS/2 


Y&S 1 wnnl to start my subscription to OS/2 Developer for only $39.95! 

Signature Date 

■ II 

YfiS 1 want to start my subscription to OS/2 Developer for only $39.95! 

Signature Date 

YES 1 want to start my subscription to OS/2 Developer for only $39.95! 

Signature Date 

O Charge ny credit card D Visa □ Mastercard □ American Express 

Card Me. Exp Date 

□ Charge my credit card: □ Visa □ Mastercard □ American Express 

Caid Mo. Exp Date 

□ Charge my credit card: □ Visa □ Mastercard □ American Express 

Card No. Em Date 

□ Bill me. 

* Canada andi Mexico add 116.00; Outside North America add £30,00 for shipping. 

Name 

□ Bill me, 

* Canada end Mexico add It B 00; Outside North America add $30 DO for shipping. 

Name 

□ Bill me. 

* Canada and Mexico add Outside North America add $3000 tor shipping. 

Name 

Tit e 
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City Slate Zip 

City State Zip 

City State Zip 

Phene Number Fax Number 
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Buyers Guide 



• , 1 

The staff of OS/2 Developer put together this special section to guide you through the various software 
tools specifically for GUI development. The products described in this guide are based on surveys sent to 
vendors; they are provided as a service to you and are free to vendors. These listings do not represent an 
endorsement by OS/2 Developer. Although every effort has been made to ensure accuracy, we do not 
assume any responsibility for error or omission in this section. 



Gui Development 
Buyer's Guide 


COMPUTER ASSOCIATES 

INTERNATIONAL INC. Circle No. 101 

CA-Realizer 2,0 r compatible with any system 
running OS/2 2.1, is a visual programming en¬ 
vironment that handles the mechanics of event- 
driven programming, message passing, and 
process sharing. It combines visual develop¬ 
ment tools. Programmable Application Tools, 
and a structured superset of BASIC extended to 
access Windows and OS/2 objects and re¬ 
sources. ODBC support and Xbase file access 
make the development of database-oriented ap¬ 
plications and client/server solutions possible. 
Features include a multiplatform functionality 
and FormDev, which allows developers to de¬ 
sign the visual elements of a program using 
standard graphical objects while automatically 
generating database query and entry forms di¬ 
rectly from existing Xbase files. Multiple forms 
may be edited simultaneously, and application 
files may be maintained together as an inte¬ 
grated project. Price; $247* 

CA-Realia II Workbench 2,0 provides a GUI 
workstation and mainframe-compatible 
COBOL development environment on the PC 
to improve COBOL applications that operate 
under Windows and OS/2. It includes a high¬ 
speed COBOL compiler, an interactive debug¬ 
ger, a COBOL-Intelligent analyzer, a CICS em¬ 
ulator, an integrated editor, and a complete life 
cycle manager with mainframe connectivity. 
The CA-Realia II Workbench is compatible 
with MS-DOS 3.3 or higher, Windows 3.1, or 
OS/2 2.L Price; $2,500. 

CA-SuperProject 10 for OS/2 is a native 32- 
bit application that exploits such OS/2 
strengths as the Workplace shell, preemptive 
multitasksing, and enhanced memory manage¬ 
ment. As a result of its compatibility across four 
platforms—OS/2, Windows, DOS, and 
VAX/VMS—a file saved on one version can be 
directly opened on another. For $59, CA- 
SuperProject users can upgrade to the full ver¬ 


sion of CA-Realizer, which provides a run time 
for royalty-free distribution of applications to 
any users. Major features include the Help 
Assist mode; Project Manager's Assistant; four 
outlines with fully integrated Gantt and his¬ 
togram charts and crosstabs, flexible PERT, and 
WBS charts; WYSIWYG reporting with unlim¬ 
ited layouts, preview, user-defined fields, and 
formulas; and resource definition, shift and 
overtime management, assignment allocation, 
efficiency factors, materials management, flexi¬ 
ble rate changes, overhead, cost accounts, C/SSR 
reporting, and cost charting. SuperProject also 
provides tracking and replanning, strong multi- 
project management, LAN support, function- 
level password security, import/export, macros, 
and multiplatform support. Price: $649. 

Computer Associates International Inc., 
One Com u pier Associates Plaza, Islandia, N.Y. 
11788-7000, (800) CALL CAI or (516) 342-5224, 
fax (516) 342-5734. 

EASEL CORP. Circle No 1 .102 

Object Studio is an object-oriented toolset for 
rapid development of large-scale production 
client/server applications. Object Studio 
includes Sychronicity 2.1 for business object 
modeling, auto-generation of Smalltalk code, 
and persistent object mapping. In addition, 
Object Studio contains ENFIN Smalltalk 4.1 for 
visual design and connectivity options and 
TeamBuilder 1.0 for group development. Price: 
$2,995 depending on platforms and options. 

Sychronicity 2J is a visual development 
toolset for maximizing the productivity gains of 
object technology through the design and man¬ 
agement of business objects. Developers build 
high-level business models providing the foun¬ 
dation for applications. Smalltalk code is auto¬ 
matically generated through the modeling tool. 
The mapping tool quickly links models to rela¬ 
tional databases. Price: $1,995 depending on 
platforms and options. 


M A Y / J U N E 1 $ $ 5 


65 





Enfirt Smalltalk 4.1 is a comprehen¬ 
sive, visual Smalltalk development envi¬ 
ronment within the Object Studio family 
of object-oriented visual development 
tools for building large-scale production 
client/server applications, ENFIN sup¬ 
ports the industry's range of connectivity 
options and facilitates access to all major 
relational database management sys¬ 
tems, Price: $2,995 depending on plat¬ 
forms and options, 

TeamBoilder 1,0 is a member of the 
Object Studio family of object-oriented vi¬ 
sual development tools for building large- 
scale production client/server applica¬ 
tions. TeamBuilder enables groups of 
developers to simultaneously build ob¬ 
ject-oriented applications, A developer 
can group objects together as a project 
while each object maintains a separate re¬ 
vision level, date-stamp, and label. Price: 
$495 depending on platforms and options. 

Easel Corp., 25 Coporate Dr., 
Burlington, Mass. 01803, {SOO)-OBJECTS 
or (617) 221-2100, fax (617) 221-3099. 

FLEXUS 

INTERNA TIONAL CORP Circle No. 103 

COBOL spll 3.1 allows developers to 
implement advanced GUI screens in 
their COBOL programs using standard 
COBOL CALL statements, COBOL spll 
supports transparent migration of 
screens and COBOL source code across 
different GUIs, across different operating 
systems, and from character mode envi¬ 
ronments to graphical environments, 
such as OS/2 Presentation Manager. 
Price: $1,000. 

Flexus International Corp., P.O, Box 
640, Bangor, Pa, 18013, (610) 588-9400, 
fax (610) 588-9475, 

MOCKWARE INC. Circle No. 104 

VhPro/C 1.1 is a full-featured OS/2 2.x vi¬ 
sual programming tool for the IBM C-Set 
and C-Set ++ First Step compilers. It pro¬ 
vides drag-and-drop programming for 
creating multithreaded, 32-bit graphical 
user interface applications. VisPro/C in¬ 
cludes Workplace Shell integration, CUA 
'91 objects, a graphical class browser, a 
visual DB2/2 database designer, and a 
SOM-based object builder. The new ver¬ 
sion includes code generation improve¬ 
ments based on recent customer feed¬ 
back. Price: $399, 

VisPro/C++ 1. Ms an OS/2 visual pro¬ 
gramming tool for the IBM C-Set++ com¬ 
piler and User Interface Class Library. It 
has all the features of VisPro/C 1,1. 
Price: $399. 

VisPro/REXX Bronze Edition 2,11 has an 

easy-to-use drag-and-drop environment 
that allows you to quickly develop 32-bit 
OS/2 2.x graphical user interface appli¬ 
cations, It includes many of the CUA '91 
objects, full Workplace Shell integration, 
multiple development views, and a 


SOM-based object builder. The Bronze 
edition provides standalone, royalty-free 
executable. The newest version features 
an improved user interface, new features 
for manipulating window frames, a more 
intelligent event editor, and a new% lower 
price- Upgrade to the Gold edition is 
available. Price: $59, 

VisPro/REXX Gold Edition 2.11 is a pro¬ 
fessional drag-and-drop visual program¬ 
ming tool for 32-bit OS/2 2.x graphical 
user interface development. It includes 
all CUA '91 objects plus 3-D business 
graphics and multimedia, full Workplace 
Shell integration, multi thread support, a 
visual DB2/2 database designer, multi¬ 
ple development views, a SOM-based 
object builder, and a standalone, royalty- 
free executable. This edition features new 
notebook events and APIs, improved 
container column and API features, and 
support for programming-shared mem¬ 
ory. Price: $299. 

Hockware Inc., 315 N. Academv St, 
Ste. 100, Cary, N,C. 27513, (919) 380-0616, 
fax (919) 380-0757. 

IBM Circle No. 105 

IBM Visual Age 2.0 combines object-ori¬ 
ented programming with the visual con¬ 
nection of prefabricated software compo¬ 
nents or parts. According to the 
company, VisualAge facilitates the cre¬ 
ation of industrial-strength line-of-busi- 
ness applications for the client/server 
environment, VisualAge Team, for 
$4,995, includes features such as COBOL 
language, communications/transaction, 
multidatabase, multimedia, and AS/400. 
Price for VisualAge: $2,495, 

IBM, 3039 Cornwallis Rd., Research 
Triangle Park, N.C 27709, (800) 426-2279 
or (919) 254-4760, fax (919) 254-4820. 

INFERENCE CORP Circle No, 106 

ART*Enterprise 1,0 for OS/2 is a client/ 
server development tool that integrates 
databases, document repositories, and 
knowledge bases. It is fully object-ori¬ 
ented and includes an extensive GUI class 
library and painter, a rule engine, and 
case-based retrieval capabilities. It is 
suited to applications that help front office 
employees interface more intelligently 
with customers and prospects. Price: 
$7,995 including one week of training. 

Inference Corp., 101 Rowland Way, 
Novato, Calif. 94945, (800) 336-9923 or 
(415) 899-0100, fax (415) 899-9080. 

INMARK Circle No. 107 

zApp Developer's Suite 2.2 facilitates the 
writing of commercial-quality applica¬ 
tions that run on multiple platforms. It 
contains zApp, aC++ application frame¬ 
work; zApp Factory, a visual designer 
and code generator for the zApp envi¬ 
ronment; and the zApp Interface Pack, a 
set of custom controls for zApp, 


Applications generated using the zApp 
Developer's Suite are single-source 
portable to 14 platforms. Price: $1,295, 

Inmark, 2065 Landings Dr., 
Mountain View, Calif 94043, (800) 346- 
6275 or (415) 691-9000, fax (415) 691-9099. 

MICRO DATA BASE 

SYSTEMS INC Circle No 108 

Object/1 3,0 is a pure object-oriented 
graphical development environment for 
OS/2 Presentation Manager 2.x or 
Windows. Object/Ts Windows Painter, 
source code management, and debug¬ 
ging tools leverage application develop¬ 
ment productivity. Object/1 is written in 
Object/1, and its source code is included 
among more than 325 classes and 7,000 
methods provided with the product. 
Object /Ts programming tools include a 
forms painter, various browsers, a work¬ 
space, notifier, breakpoint, and debugger 
tools. The price of Object/1 includes the 
development system, Application Distri¬ 
bution System, a relational database sys¬ 
tem (TBL), and the choice of an interface 
to MDBC IV or DB2/2, or in Windows to 
SQL Server or Sybase. Price: $4,000. 

Micro Data Base Systems Inc., P.O. 
Box 2438, 1305 Cumberland Ave., West 
Lafayette, Ind. 47906-0438, (800) 445-6327 
or (317) 463-7200, fax (317) 463-1234. 

MICROFOCUS Circle No, 109 

Dialog System 2.5 is a complete develop¬ 
ment environment enabling COBOL pro 
grammers to rapidly build GUI 
client/server database applications for 
multiple platforms, including OS/2, 
Windows, and DOS. This product pro¬ 
vides visual programming facilities that 
enable programmers to build, manage, 
and debug client/server applications 
using Dialog's trace and debug environ¬ 
ment. It now includes a complete ANSI 
standard relational database from XDB 
Systems, allowing applications to be 
ported to any XDB system or equivalent 
realtional database through ODBC con¬ 
nectivity. Price: $1,250. 

MicroFocus, 2465 East Bayshore Rd., 
Palo Alto, Calif 94303, (415) 8564161, fax 
(415) 856-6134, 

OPEN SOFTWARE 

ASSOCIATES INC. Circle No, 110 

Open Ul 3.1 is a Distributed User Interface 
Management System (D-UIMS) for enter¬ 
prise-scale distributed applications. It 
enables the user interface of an applica¬ 
tion to be developed once and deployed 
on any standard GUI, including 
Window's, OS/2 Presentation Manager, 
Motif and Macintosh, and on terminals. 
Open Ul's message-based architecture 
provides many unique features to 
address scalability issues for enterprise- 
wide client/server applications. Price: 
$3,500 and up. 
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Open Software Associates Inc,, 20 
Trafalgar Sq ,, Ste 500, Nashua, N.H. 
03063, (603) 8S6-4330, fax (603) 598-6877. 

PARCPLA CE SYSTEMS INC. Circle No . Ill 
Visual Works 2.0 is a client/server tool for 
building portable applications using 
object-oriented technology. A Database 
Application Creator is included for rapid 
application development. Applications 
developed are instantly portable across 
multiple platforms, are scalable across 
the enterprise, and can have their func¬ 
tionality distributed between both clients 
and servers* Price; $2,995 for OS/2, 
Windows, Windows NT, and Macintosh; 
$4,995 for UNIX. 

FarcPlace Systems Inc., 999 East 
Arques Ave., Sunnyvale, Calif. 94086- 
4593, (800) 759-7272 or (408) 481-9090, fax 
(408) 481-9095. 

SCIENTIFIC 

ENDEA VORS CORP. Circle No, 112 

GraphiC/0S2 7M is a library of C routines 
for creating publication-quality technical 
graphics. The interface is designed so it is 
possible to write a full-featured Pre¬ 
sentation Manager (PM) application 
without having to make any PM APT 
calls. Routines are provided for getting 
prompted user input and displaying text 
in a scrolling text window. Price; $495. 

Scientific Endeavors Corp., 508 
North Kentucky St., Kingston, Tenn. 
37763, (800) 998-1571 or (615) 376-4146, 
fax (615) 376-157L 

VISIBLE SYSTEMS CORP, Circle No, 113 
Visible Analyst Workbench 5,4 is a set of 

CASE tools designed for large, complex 
applications. It automates structured 
analysis, design, data modeling, and 
enterprise modeling. Version 5.4 includes 
an enhanced PowerBuilder Interface, 
new UNIFACE bidirectional interface 
support, and enhancements to its reposi¬ 
tory customization capabilities. Price: 
$2,795. 

Visible Systems Corp., 300 Bear Hill 
Rd., Waltham, Mass. 02154, (617) 890- 
2273, fax (617) 890-8909. 

WATCOM 

INTERNATIONAL CORP . Circle No . 114 

Watcom C/C++ 10,0 is a professional, mul¬ 
tiplatform C and C++ development sys¬ 
tem for 32-bit DOS, Windows NT, 
Win32s, OS/2 2*x, OS/2 Warp, and 
Novell NLMs, as well as 16-bit DOS and 
Windows 3.x* Combining its optimizing 
compiler technology with a new inte¬ 
grated development environment (IDE) 
and a comprehensive set of tools, 
Watcom C/C++ includes an advanced 
GUI debugger, C++ class browser, and 
profiler, Watcom C/C++ delivers sup¬ 
port for C++ templates, exception han¬ 


dling, and Microsoft Foundation Class 
(MFC) libraries. Price: $199. 

Watcom VX-REXX 2,1 is an integrated 
environment for developing OS/2 
Presentation Manager applications, in¬ 
cluding a project management facility, 
visual designer, and debugger. This en¬ 
hanced version contains notebooks, con¬ 
tainers, sliders, pop-up menus, and DDE 
objects. Price: $99. 

Watcom VX-REXX Ctient/Server Edition 

2.1 is a visual development environment 
for OS/2. Connection, query, and chart ob¬ 
jects allow you to access several datatbases, 
manipulate data, and chart the results 
quickly and easily. Features include drag- 
and-drop programming; bound controls; 
and professional multithreaded, multi win¬ 
dowed, and drag-and-drop enabled appli¬ 
cation development* Price: $299. 

Watcom, 415 Phillip St., Waterloo, 
Qnt., Canada* N2L 3X2, (800) 265-4555 or 
(519) 886-3700 , fax (519) 747-4971, 

XVT SOFTWARE INC Circle No. 115 

XVT Development Solution for C 4.0 (DSC) 
pairs XVT-Design, a visual GUI layout, 
prototyping, and code generation tool 
with the XVT Portability Toolkit, a thin- 
layered API* XVT-Design generates XVT 
Portability Toolkit compatible C source 


code, application resources, and make¬ 
files. Applications developed with DSC 
will have native look-and-feel and single- 
source portability to seven different GUIs 
and over 30 hardware platforms. Sup¬ 
ported GUIs include: OS/2, Windows, 
Windows NT, Macintosh, OSF/Motif for 
UNIX and VMS, and Character Screens for 
DOS, UNIX, and VMS. Price: $2,325. 

XVT Development Solution for C++ 3.2 
(DSC++), featuring XVT-Power++, is an 
application framework for developing 
object-oriented GUI applications for over 
20 platforms* XVT-Power++ uses the 
Model-View-Controller paradigm to pro¬ 
vide high-level functionality, such as au¬ 
tomatic data propagation and environ¬ 
ment inheritance, plus fully integrated 
Rogue Wave data structures. D5C++ also 
includes XVT-Architect, a visual applica¬ 
tion builder used for the entire applica¬ 
tion development life cycle, from design 
to layout to final application building. 
DSC++ allows developers to create sin¬ 
gle-source applications with native look- 
and-feel on OS/2, Windows, Windows 
NT, Macintosh, and OSF/Motif. Price: 
$2,325* 

XVT Software Inc., 4900 Pearl East 
Circle, Boulder, Colo. 80301, (800) 678- 
7988 or (303) 443-4223, fax (303) 443-0969. 
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Advanced T«k Scheduler for O 9/E 

ATS 

Version 3.0 



Are you looking for s way co 
manage your production job 
streams? Do you have programs 
that need to run after the 
completion of one or more other 
programs? Do you want to run 
programs on a regular basis? Do 
you want to process files that 
have just been received from 
another system or modified 
locally? Do you need to take action 
if a file is miasing? Do you need to 
schedule around holidays and 
periods of heavy CPU load? 

With ATS you can run your 
programs when YOU want them 
to run with out you having to be 


there - d 

Software and Gonsuibft 9 

+-*** 2227 U.S, Highway #1 *Suite 146 

North Brunswick, NJ 08902 


Hers are some of the features of 
ATS for 08/2: 

* Manage Production Job 
Streams 

* Programs can be scheduled to 
run anytime. 

* Programs can be dependent 
upon Files, Ocher Programs, 
Hoiday Schedules, and 
External Signals 

* Integrated Operators Console 

* Logging-To File and Console 
New Features: 

* Job Queues-for managing 
your resources while managing 
your tasks 

* Periodic Scheduling 

* COMPLETE A PI and Command 
Line Interface 



Vote* 
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Spotlight OS/2 Library 


This list was provided by Gail Ostrow at IBM's Independent Vendor League (IVL). The IVL provides 
support for OS/2 authors and publishers. Gail can be reached via e-mail at gailo@vnet. ibm.com or by 
fax at (203) 368-6379. 



NOTE; In March 1995, John Wiley & Sons Inc. purchased Van Nostrand Reinhold's (VNR) OS/2 computer book list 

OS/2 Warp Books 

The following books were written or upgraded for OS/2 Warp. All categories (Novice, Intermediate, and Advanced) are 
shown. 

The Art of OS/2 Warp Version 3 C Programming , 0-471-08633-9, Panov et at John Wiley & Sons 

Complete Idiot's Guide to OS/2 Warp f 1-56671-589-9, Alpha 

Connecting with LAN Server 4.0,1-56276-270-2, Nance, Ziff-Davis 

The Design of OS/2, 2nd Edition, 0-201-52886-X, Kogan & Dietel, Addison-Wesley 

Developing High-Powered OS/2 Warp Applications, 0-471-11586-X, Reich, John Wiley & Sons 

Developing Multimedia Applications Under OS/2 , 0-442-01929-7, Lopez, VNR 

Dynamic Data Development for OS/2 , 0-442-01949-1, Puchtel, VNR 

A Guide to Learning the Internet with OS/2 Warp , 1-56884-465-4, IBM Press (IDG) 

Inside OS/2 Warp Version 3,1-56205-378-7, Mina si, New Riders 

Internet Connections with OS/2 Warp , Ivens, Prima 

Lotus Notes Version 3 in the OS/2 Environment , 0-442-01890-8, Walsh, VNR 

OS/2 Work for You: Installing, Configuring & Using OS/2 Warp, 0-471-06083-6, Azzarito & Green, John Wiley & Sons 
Mastering OS/2 Warp Version 3,0-7821-1663-9, Dyson, Sybex 
Navigating the Internet with OS/2 ,0-672-30719-7, Tyson, Sams 
Official Guide to Using OS/2 Warp , 1-56884-466-2, IBM Press (IDG) 

OS/2 C++ Class Library: Power GUI Programming with C Set++, 0-442-01795-2, Law et at, VNR 
OS/2 for Dummies , 2nd Edition {Warp Version 3), 1-56884-205-8, Rathbone, IDG Books 
OS/2 Presentation Manager GPI, 2nd Edition, 0-442-01939-4, Winn, VNR 
OS/2 Programmer's Desk Reference, Gopaul, McGraw-Hill 

OS/2 Remote Communications: Asynchronous to Synchronous Tips and Techniques, 0-442-01814-2, Stonecipher, VNR 

The OS/2 Survival Kit , 0-201-40915-1, Proffit, Addison-Wesley 

OS/2 Warp Answers, 0-0788-5-0 Ivens, Osborne/McGraw-Hill 

The OS/2 Warp Bible , 1-55755-268-X, Albrecht & Plura, Abacus 

OS/2 Warp Control Program API, 0-471-03887-3, Stock, John Wiley & Sons 

OS/2 Warp : Easy Installation Guide , Kamin, Prima 

OS/2 Warp Presentation Manager API , 0-471-03873-3, Stock & Barnum, John Wiley & Sons 

OS/2 Warp Presentation Manager Programming for Power Programmers , John Wiley & Sons, 0-471-05839-4, Stern & Morrow 
OS/2 Warp v.3 Unleashed , Deluxe Edition, 0-672-30595-3, Moskowitz et at,, Sams 
The OS/2 Warp Version 3 Goldmine, Patton, VNR 

OS/2 Warp Vers/cm 3 Presentation Manager Mentor, 0-442-01989-0, Drapkm, VNR 

OS/2 Warp Workplace Shell API , 0-471-03872-5, Pollack & Stock, John Wiley & Sons 

The Photo CD Book (w/disk with OS/2 Warp applications), 1-55775495-2, von Bulow & Paulissen, Abacus 

Programming the OS/2 Warp Version 3 GPI , 0-471-10718-2, Knight & Ryan, John Wiley & Sons 
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Running Windows Applications in OS/2: A Power User's Guide , 0-442-01924-6, Anise et al, VNR 

Secrets of the OS/2 Masters , 0-442-01991-2, Sullivan, VNR 

Stepping up to OS/2 Warp , 1-55755-269-X, Albrecht & Plura, Abacus 

Teach Yourself OS/2 Warp v3 in a Week, 0-672-30684-0, Sams 

Your OS/2 Warp Consultant, 2nd Edition, 0-672-30484-8, Tyson, Sams 

Using the OS/2 Warp BonusPak, 1-55755-285-1, Hoff, Abacus 

Using OS/2 Warp Version 3, Special Edition, 0-7897-0088-3, Clifford et al, QUE 

The Warp Book: Your Definitive Guide to Installing and Using OS/2 v3 f 0-7615-0034-0, Sosinsky, Prima 

Warping to the Internet, 1-55755-284-3, Salomon, Abacus 

Other OS/2 Programming Books 

The foliowing OS/2 programming books were not specifically written for 
OS/2 Warp but are appropriate for OS/2 2.X and Warp versions. 

Advanced OS/2 Presentation Manager Programming, 0-471-59198-X, Burge & Cell, John Wiley & Sons 

The A rt of OS/2 C Programming, 0-471-58802-4, Panov et al, Wiley-QED 

C & C++ Programming in the OS/2 Environment , 0-442-01240-3, Gopaul, VNR 

Ctient/Server Programming with OS/2 2.1, 3rd Edition, 0-442-0! 8333-9, Orfaii & Harkey, VNR 

A Client-Server Survival Guide With OS/2 , 0-442-01798-7, Orfaii & Harkey, VNR 

Cross Platform Programming in OS/2,0-07-017862-3, Dorfman, McGraw-Hill 

Designing OS/2 Applications , 0-471-58889-X, Reich, John Wiley & Sons 

Effective Multithreading in OS/2, 0-070017841-0, Dorfman, McGraw-Hill/PC 

Jnsffmt OS/2 - Porting C Applications to OS/2, 0-8306-4522-5, Dorfman, McGraw-Hill 

GUI-OOUl Wars: Windows Vs, OS/2, 0-442-01750-2, Mandel, VNR 

Object Oriented Programming Using SOM & DSOM, 0-442-01948-3, Lau, VNR 

Objects for OS/2, 0-442-01738-3, Danforth et al, VNR 

The OS/2 21 Application Programmer's Guide, 0-442-01736-7, Kelly et al., VNR 

The OS/2 2.1 Corporate Programmer's Handbook, 0-442-01598-4,Scholin, et aL, VNR 

OS/2 21 Programming , 0-07-881910-5, Schildt & Goosey, Osborne McGraw-Hill 

OS/2 21 Workplace Shell Programming, 0-679-79162-0, Random-House 

OS/2 2.X Notebook (Best of OS/2 Developer), 0-442-01522-4, Conklin, VNR 

OS/2 Batch Files To Go, 0-070052370-3, Richardson, McGraw-Hill /Windcrest 

OS/2 Lan Server: The Do-it-Yourselfer's Guide to Perfect Networking, 0-442-01958, Scherer, VNR 

OS/2 and Netivare Programming: Using the Netware Client API for C, 0-442-01815-0, Adair et aL, VNR 

OS/2 PM Programming for COBOL Programmers , Revised Edition, 0-471-56140-1, Chapman, Wiley-QED 

OS/2 Presentation Manager Programming, 1-56276-123-4, Petzold, Ziff-Davis 

OS/2 Presentation Manager Programming: Hints & Tips , 0-07-70776-8, Goodyer, McGraw-Hill 

OS/2 V2 C++ Class Library: Power GUI Programming with C Sct++, 0-44 2-01795-2, Law et al, VNR 

Quick Reference Library for OS/2 Functions: Vol 1 - Win Functions, 0-442-018975, Scholin, VNR 

Qwidt Reference Library for OS/2 Functions: Vol 2 - Message Functions , 0-442-018983, Scholin, VNR 

Real World Programming for OS/2 21, 0-672-303004), Blain et al, Sams 

Real World Programming for OS/2 211, 0-672-30563-1, Blain et al., Sams 

The Ultimate OS/2 Programmer's Manual, 0-07-043972-9, Mueller, McGraw-Hill 

Writing OS/2 Device Drivers in C 2nd edition, 0-442-01729-4, Mastrianni, VNR 

REXX Programming Books 

Application Development Using OS/2 REXX, 0-471-60691 -X, Rudd, Wiley-QED 
Mastering OS/2 REXX, 0-471-51901-4, Gargiulo, Wiley-QED 
OS/2 21 REXX Handbook, 0^4424)1734-0, German, VNR 

REXX: Advanced Techniques for Programmers, 0-07-034600-3, Kiesel, McGraw-Hill 

The REXX Cookbook: A Tutorial Guide to REXX in OS/2 for the IBM PC, 0-9632773-4-0, Callaway, Sams 

REXX Reference Summary Handbook, 2nd Edition, 0-9639854-2-6, Goran, CFS Nevada 

REXX Toois and TEchniques, Nimal, John Wiley & Sons 

Teach Yourself REXX in 21 Days, 0-672-305291, Schindler & Schindler, Sams 

McGraw-Hill, Writing OS/2 REXX Programs, 0-07-052372-X, Richardson 

McGraw-Hill, Writing VX-REXX Programs, 0-07-9119-10, Richardson 
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Product Watch 



New Products for OS/2 


AM/Solo. This 4GL development tool for OS/2 
maintains a CUA '91 library, including 
Notebook, Container and Slider Support. It 
provides extensive database support to 
DB2/2, DDCS/2, SQLServer, and Oracle and 
communication support for APPC, EHLLAPI, 
and Named Pipes. AM features full preemp¬ 
tive multitasking, online dictionaries, and full 
support of Warp flat memory models and 32- 
bit architecture for fast execution. 

Intelligent Environments Circle No. 151 
Phone: (800) 669-2797, (508) 640-1080, Fax: 
(508) 640-1090 

ATS 3.0 for OS/2. MHR Software and 
Consulting announces the release of 
Advanced Task Scheduler for OS/2 3.0. ATS 
is a production job scheduling utility that 
can be used by end users, developers, and 
on-network servers. Features include unlim¬ 
ited number of user-defined tasks, job 
queues to control resource utilization, 
events, and holidays; complete logging; API 
interface to all of the ATS features, U.S. or in¬ 
ternational date and time formats; and a con¬ 
sole display of log, status, and running task 
information. ATS is a multithreaded, 32-bit 
OS/2 Presentation Manager application 
written entirely in C and compiled using 
IBM's C Set++ version 2.1. 

MHR Software and 

Consulting Circle No. 152 

Phone: (908) 821-0359, Fax: (908) 821-0350 

CodeCheck 5.0. This software analysis tool al¬ 
lows automation of the C++ Quality 
Assurance Process. This technology will vali¬ 
date all source code produced as being in 
compliance or not. Individual programmers 


having access to this product are able to cor¬ 
rect their code before submission to the 
Quality Assurance Manager. CodeCheck 
reads all variants of C and C++ source code 
and is available for OS/2, Windows 95, and 
Macintosh. Source code for CodeCheck is 
available for license on all minicomputer and 
mainframe sites. 

Abraxas Software Inc. Circle No. 153 

Phone: (503) 244-5253, Fax: (503) 244-8375 

Colorado Backup for OS/2. As a 32-bit applica¬ 
tion that takes advantage of OS/2's multi¬ 
tasking abilities, this product features five 
backup methods, custom file set recording, 
unattended scheduling, data compression, 
and command line operation. Supporting 
jumbo and Trakker 120, 250, and 350 tape 
backup systems, it includes a two disk disas¬ 
ter recovery utility. It backs up FAT and 
HPFS systems and handles long filenames 
and extended attributes. Colorado Backup 
supports OS/2 2.1 and above, OS/2 Warp, 
and popular OS/2 networks. 

Colorado Memory 

Systems Direct Circle No. 154 

Phone: (303) 635-1500, Fax: (303) 663-7482 

DataEase 5.0 for DOS and OS/2. This database 
software allows professional developers to 
build applications that present different 
views of the same database. Ultimately, peo¬ 
ple and departments view only the informa¬ 
tion they need, while filters ensure confiden¬ 
tial data remains private. Developers can 
also place different parts of a database on 
different drives and directories. DataEase 5.0 
for DOS and OS/2 and DataEase 5.0 for 
Windows are designed to share the same 
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database so people and departments through¬ 
out an organization can work together. 

DataEase International Circle No, 155 

Phone: (203) 374-8000, Fax: (203) 365-2317 

DataTable 2.5. The Presentation Manager- 
based Spreadsheet/Grid Control is a devel¬ 
op ment tool for OS/2. Within the operating 
system, the user can create complex data 
entry and display screens. The DataTable 
control offers several memory management 
schemes, including virtual memory manage¬ 
ment. With DataTable the user has the ability 
to display, manage, and edit rows, columns, 
and cells of data in a spreadsheet-like man¬ 
ner, The user can display database queries 
and multidimensional arrays of information, 
with over two billion rows and up to 250 
columns. Features include setting fonts and 
colors for row and column labels, split win¬ 
dows, support for database null values, en¬ 
hanced keyboard support, hidden columns, 
and faster column sorting with up to three 
sort keys. 

ProtoView Development Co, Circle No. 156 
Phone: (800) 231-8588, (908) 329-8588, Fax: 
(908) 329-8624 

High C/C++ 3.3. This 32-bit global optimizing 
compiler for OS/2 works with IBM's System 
Object Model (SOM) to break the tight bi¬ 
nary coupling and extend the advantages of 
procedure libraries to object-oriented tech¬ 
nology. The breakthrough is achieved by a 
functionality called DirectToSOM, which en¬ 
ables developers to directly create and 
embed SOMobjects in the C++ programs. 
New features for 3.3 include fully imple¬ 
mented C++ exception handling, including 
nested exceptions; advanced namespace ca- 
pabiiities to avoid potential name clashes 
with third-party libraries; exclusive run- 
time-type information and cast notation; 
templates that track the draft ANSI C++ 
Standard; Easy Thread functionality that gen¬ 
erates code for thread-local storage; and pro¬ 
gramming support for IBM's Workplace 
Shell 

Meta Ware Inc. Circle No. 157 

Phone: (408) 429-6382, Fax: (408) 429-9273, 

HLPOK/PA 12.5c. This is a multiplatform help 
authoring tool that supports the creation of 


help files for multiple environments from 
one source file. The product includes con¬ 
verter programs from WinHelp, the Norton 
Guides, and Pop Help to HLPDK. With these 
converters, help files that were created on 
DOS and Windows environments can be 
translated to OS/2 and the Internet's World 
Wide Web. 

HyperAct Inc. Curie No. 158 

Phone: (319) 351-8413 

Lotus Value Pack for OS/2. A collection of pro¬ 
ductivity tools, this package serves to en¬ 
hance Lotus SmartSuite for OS/2 and the 
OS/2 Workplace Shell (WPS). This product 
improves users' day-to-day efficiency by 
tightening the integration between 
SmartSuite applications and the WPS, as 
well as among the SmartSuite applications 
themselves. The Value Pack for OS/2 com¬ 
prises five components: SmartCenter for 
OS/2, Ami Pro Bonus Pack macros, the 1-2-3 
File Translator, new Freelance SmartMaster 
presentation styles and business symbols, 
and REXXLink for 1-2-3. 

Lotus Development Corp. Circle No. 159 
Phone: (404) 828-5395 

MKS RC$ 5,2, This Revision Control System 
solves the problem of managing change dur¬ 
ing project development. It keeps a complete 
history' of file changes and retrieves any ver¬ 
sion quickly and easily. Version 5.2 is a con¬ 
figuration management system that offers en¬ 
hanced security and flexibility for distributed 
project development environments, plus a 
menu interface, binary and text file support, 
and supple configurability. It features an en¬ 
cryption facility for sensitive data, a user-con¬ 
figurable directory search path and filename 
template for RCS files, reverse delta storage, 
and full command line operation. 

Mortice Kern Systems Inc./ 

Felder Computers Circle No. 160 

(904) 778-2482 

PartitionMagic for OS/2. This software utility 
permits users to visually move, shrink, ex¬ 
pand, and convert their hard disk partitions. 
This product facilitates the process of creat¬ 
ing space for a Boot Manager partition and 
automatically converts FAT partitions to 
HPFS. PartitionMagic for OS/2 includes a 
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K 32-bit DOS executable with a GUI to 
j help DOS users modify their partitions. 

PowerQuest Corp. Circle No. 161 
Phone; (800) 379-2566 or (801) 226- 
8977, Fax: (801)226-8941 

PMCS-W00. Providing connection to a 
computer via the parallel port or SCSI 
port, PMCS-1000 is a two GB 3.5-in. 
minicartridge tape system housed in a 
portable minichassis with an internal 
auto-sensing power supply. It is a 
complete portable backup solution fea¬ 
turing parallel cable, SCSI cable, 
Quickstart User's Manual, PSS Soft¬ 
ware Package, and single-pass back¬ 
up/verify operation. PCMS-1000 has a 
native storage capacity of 840 MB on a 
standard minicartridge and 1 GB on 
the new QIC-Wide Mini-Cartridge (in¬ 
cluded with the product) and com¬ 
pressed capacity of 1.7 GB and 2 GB, 
respectively. It provides for 8- to 18- 
MB/min. backup through a parallel 
port and up to 36 MB/min. through a 
SCSI port. The read-after-write capa¬ 
bility of PMCS-1000 provides for sin¬ 
gle-pass backup/verify and restore/ 
compare operations, saving time and 
guaranteeing data integrity. 

Parallel Storage 

Solutions Circle No. 162 

Phone: (800) 998-7839, (914) 347-7044, 
Fax: (914) 347-4646 

ProMod. A system of CASE software 
development tools, ProMod is de¬ 
signed to run on open heterogeneous 
systems and supports popular design 
methodologies such as, Yourdon/ 
DeMarco, McMenamin/Palmer, and 
Jackson Structured Analysis. With op¬ 
tional features, this product can be 
used for generating code (for C, FOR¬ 
TRAN, and C++), reverse engineer¬ 
ing, schema generation, GUI design, 
and interactive simulation of system 
designs. 

G&E Systems Lnc. Circle No. 163 

Phone: (800) 445-7899, (617) 784-1007, 
Fax: (617)784-1737 

Recare 3.0. Recore 3.0 offers an ad¬ 
vanced set of integrated optical charac¬ 
ter recognition (OCR) software C-func¬ 
tions designed to create accurate and 
reliable OCR applications. This func¬ 
tion library with a high-level program¬ 


ming interface controls and manages 
the recognition operation, session con¬ 
trol, and image and file registration. 
Recore 3.0's technical features include 
dual engine technology with Omnifont 
technology and training engine. 
Adaptive Intelligent Engine for im¬ 
proved efficiency, a modular com¬ 
mand library, rule-based intelligent 
page segmentation providing the abil¬ 
ity to read magazine and newspaper 
text while retaining the original layout, 
and zone data typing that enhances ac¬ 
curacy by configuring the software to 
read specific character formats on a 
zone by zone basis. 

MAXSOFT-Oeron Inc. Circle No. 164 
Phone: (800) 933-1399, (510) 252-0200, 
Fax: (510) 252-0202 

Remote-OS , The new function for 
Remote-OS will provide access to DOS 
and OS/2 Text applications over 
TCP/IP connections. A license of 
PCP/1P for OS/2 from IBM is re¬ 
quired to complete this new approach 
to Internet/Telnet application servers 
and network gateways. The combina¬ 
tion of these products will allow ter¬ 
minals to be concurrently connected 
via serial ports and/or LAN adapter 
cards, providing access to real applica¬ 
tions, such as cc:Mail or WordPerfect. 
These applications will run as if they 
were running on a terminal or 
Desktop PC. 

The Software 

Lifeline Inc. Circle No. 165 

Phone: (407) 994-4466, Fax: (407) 994- 
6304 

Sytos Premium Z1. This backup and re¬ 
covery software offers OS/2 Warp 
users an intuitive Presentation 
Manager user interface that facilitates 
file selection and job execution. It in¬ 
cludes Sytos Rebound, a disaster recov¬ 
ery utility that protects OS/2 Warp 
workstations and servers from total 
system failure. Designed to appeal to 
OS/2 Warp users, this product features 
a graphical user-friendly interface and 
automated operations, Sytos Premium 
has been updated to support additional 
command line switches, all network 
file and directory Access Control Lists, 
file permissions, and network system 
files. In addition, Sytos Rebound recov¬ 
ery utility will install on HPFS systems 


using lowercase files. Sytos Premium 
provides optional autoloader device 
support with Sytos Autoloader 2.1 
support module for OS/2, 

Sytron Corp. Circle No. 166 

Phone: (508) 898-0100, Automated fax 
response line: (508) 898-0001 

TechSridge Builder 12, The new release 
of this visual development tool in¬ 
cludes master detail data display, use 
of Notebook control within a form, au¬ 
tomated display of three-dimensional 
business graphics on a query form, 
and OS/2 Warp support. In addition. 
Tech Bridge has implemented an SQL- 
smart object framework that under¬ 
stands interfacing with the DB2 family. 
This includes transaction management, 
maintaining unit-of-work integrity, 
schema import, catalog fetch, business 
graphics and security interface, DDCS 
interface, and composition of prepare 
and select statements. For the profes¬ 
sional developer, there are complete 
APIs for direct data access and manip¬ 
ulation. 

TechBridge Technology 
Corp. Circle No. 167 

Phone: (800) 463-8998, (416) 222-8998, 
Fax: (416) 222-0168 

X:Change. This fully graphical cross¬ 
platform management environment is 
specifically designed to meet the needs 
of application programmers that de¬ 
velop mainframe and client/server 
software on the workstation. Its 32-bit 
application provides programmers 
with technology to manage, transfer, 
and synchronize MVS and OS/2 files 
with point-and-click and drag-and- 
drop manipulation, X:Change can ac¬ 
commodate sequential, PDS(E), CA¬ 
PA NV A LET, and CA-LIBRARIAN file 
structures on the mainframe and FAT, 
HPFS, and PVCS file formats on the 
PC. During transfer, it automatically 
converts EBCDIC to ASCII and vice 
versa. Also included is SmartCopy, a 
transfer technology that identifies du¬ 
plicate versions of data set members or 
files on the target platform (even if 
they are named differently) and trans¬ 
fers only the nonduplicate versions, 

Serena International Circle No. 168 
Phone: (800) 457-3736, (415) 696-1800, 
Fax: (415) 696-1776 
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POWER UP WITH 

THE RIMSTAR PROGRAMMER’S EDITOR 

NEW VERSION 2.1 
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If you're looking for a fully configurable, professional OS/2 PM 
programmer's editor to replace your current text-mode editor - we 
have what you have been looking for! 

No hassle changing editors 

We know changing editors can be a major hassle You don't want 
to relearn a new set of keystrokes no matter how good the product. 
Well, you don't have to - we have Brief, CUA, Epsilon, Multi-Edit, 
SlIckEdtt, PWB, and Borland IDE keyboard mapping waiting for you. If 
you're not using one of these, let us know and we will create the 
mappings you need, 

Features designed to Increase productivity 
It has all the features you have come to expect plus special 
features designed to anticipate your needs and increase your 
productivity. Features like a 'C' source browser lhat eliminates those 
time consuming searches for functions global variables lypedefs, 
and macros by providing you wtth instant positioning to both 
definitions and references Using our powerful *C' macro language 
you can customize your programming environment to suit your 
Individual needs 


Portiat Feature List 


Complete ANSI 'C macro language 
SyntaColor™—syntax highlighting 
Smart C/C+ + Indenting & brace matching 
Bookmarks 

Unlimited undo and redo 
Timed auto save 

Access PDK help for function under cursor 
Multi-threaded for no waiting 
Compile and jump to errors 
tmport/export to system clipboard 
Keystroke record/playback 
Block indent/outdent 
Hex editing 
Customizable menus 

Column, line and block 
selection, search and replace 

Integrates with Workframe/2 
Source browser for ‘O' 

Template editing 

Multi-buffer regular expression 
search and replace 

Support for version control 

Complete on-line help 

Save and restore state between sessions 

OS/2 2,x 32 bit PM Multi-document 
interface 
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'My copy of Brief has been permanent^ 
retired Kfeep up the good woriri' - AL 


RimStdr Technology, Inc. 

91 Halls Mill Road 
Newfields, NH 03856 
Voice: (603) 778-2500 
Fax: (603) 778-2408 
BBS: (603) 778-4644 


Price $299.00 

Plus Shipping & Handling, 

To order call 1 -800-746-7007 

60 day money-back guarantee. 

Also available for Windows and Windows NT 


All products and company names a re 
trademarks a ifcgteten&d tiodemarics of their 
respective holders. RlmStor end SyntaCcto 
ora trademalffl of RlmStor IsdhnoiogVH Inc. 


© 1994 RtmSfar Technology me 
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In the Race for Solutions, 

Finish First 



IntroducingVisPro/Reports, the first programmable 
report writer for VisPro/REXX, VX REXX and OS/2 REXX 


On April 28,1993 HockWare Inc. shipped 
VisPro/REXX, the first OS/2 visual programming tool 
for REXX. Since then, we’ve achieved many other 
firsts. VisPro/REXX, VisPro/C and VisPro/C++ are the 
first REXX, C and C++ tools to incorporate drag and 
drop programming, an entity-relationship database 
designer, and a rich set of add-on objects including: 
spreadsheet, business graphics, formatted entry field, 
clock and calendar. Whether you’re using REXX, 
C-Presentation Manager, or IBM’s User-Interface Class 
Library, there is a VisPro product to meet your needs. 

Yet Another First 

VisPro/Reports is the latest addition to the VisPro 
family of OS/2 programming products. VisPro users 
will recognize the easy-to-use 
Cl’A’91 user-interface and 
the drag and drop 
style HockWare 
pioneered years ago. 

Designing Reports 
is Easy 

• WYSIWYG, free-format 
report design tool. 

HockWare. VisPrcVC. VisPro/C++. VisPnVREXX ami VisPnVRc 
are trademarks of HockWare Incorporated. All other company, 
products and brand names are trademarks and/ or registered 
trademarks of their respective holders and are mentioned for 
reference purposes only. © 1995 HockWare Incorporated. 

All rights reserved. 


• Banded report options allow you to choose 
from a rich set of headers, footers and groups. 

• Label reports allow you to select from a large list 
of Avery' labels. 

• Support for multiple line text, derived fields, 
business graphics, bitmap images, rectangles, 
lines and ellipses. 

• Many object properties to choose from, including 
any OS/2 font, 16 million colors, line styles, 

fill patterns and drop shadows. 

• Wide selection of field options, International 
currency and formulas. 

• Numerous sample reports included. 

Report Printing is Easy 

• Seamlessly print or preview reports from any 
OS/2 REXX environment including VisPro/REXX, 

VX REXX and plain OS/2 REXX. 

• Use your favorite REXX-enabled databases and third 
party libraries for access to DB2, .DBF files, 
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The Complete VisPro Family 

VisPro/Reports.$199 

VisPro/REXX Gold.$299 

VisPro/REXX Bronze.$~^99 $ 59 

VisPro/REXX Data Entry Object Rack$t99 $ 89 

VisPro/C or VisPro/C++.$399 $199 special 

VisPro Development Suite.$599 $499 

(includes VisPro/REXX Gold, C and C++) 


Whether y ou've already discovered the 
VisPro family of visual 
programming products or you’re 
just getting to know us, meet 
our latest member, 

VisPro/Reports. And be the first 
to get where you’re going. 




HockWare Incorporated 

P.O. Box 336 

Cary. NC 27512-0336 

919-380-0616 

919-380-0757 FAX 

Go HockWare on CompuServe 

hockware@vnet.net on Internet 
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